The Speech ManagerSpeech Manager Overview 2Speech Manager Concepts 3Using the Speech Manager 4Getting Started 4Determining If the Speech Manager Is Available 4Which Version of the Speech Manager Is Running? 5Making Some Noise 5Determining If Speaking Is Complete 6A Simple Example 6Essential Calls—Simple and Useful 7Working With Voices 7Managing Connections to Speech Synthesizers 11Starting and Stopping Speech 13Using Basic Speech Controls 14Putting It All Together 17Advanced Routines 18Advanced Speech Controls 19Converting Text Into Phonemes 23Getting Information About a Speech Channel 24Advanced Control Routines 30Application-Defined Pronunciation Dictionaries 36Associating a Dictionary With a Speech Channel 37Pronunciation Dictionary Data Format 38Creating and Editing Dictionaries 39Advanced Voice Information Routines 39Embedded Speech Commands 40Embedded Speech Command Syntax 41Embedded Speech Command Set 42Embedded Speech Command Error Reporting 45Summary of Phonemes and Prosodic Controls 45Summary of the Speech Manager 49This document describes the Apple® Speech Manager, which provides a standardized method for Macintosh® applications to generate synthesized speech.The document provides an overview of the Speech Manager followed by general information about generating speech from text. The necessary information and calls needed by all text-to-speech applications are given next, followed by a simple example of speech generation. More advanced calls and special-purpose routines are described last.Speech Manager OverviewA complete system for speech synthesis consists of the elements shown in Figure 1-1.Figure 1-1 Speech synthesis componentsAn application calls routines in the Speech Manager to convert character strings into speech and to adjust various parameters that affect the quality or character of the spoken output. The Speech Manager is responsible for dispatching these requests to a speech synthesizer. The speech synthesizer converts the text into sound and creates the actual audio output. The Apple-supplied voices, pronunciation dictionaries, and speech synthesizer may reside in a single file or in separate files. These files are clearly identifiable as Speech Manager–related files and are installed and removed by being dragged into or out of the System Folder. Additional voices can be provided by bundling the resources in the resource forks of specific applications. These resources are considered private to that particular application. It is up to the individual developers to decide whether the voice resources they provide are usable on a systemwide basis or only from within their applications. In the first release of the Speech Manager, pronunciation dictionaries are managed entirely by the application. The application is free to store dictionaries in either the resource or the data fork of a file. The application is responsible for loading the individual dictionaries into RAM and then passing a handle to the dictionary data to the Speech Manager.Applications that use the Speech Manager must provide their own human interface for selecting voices and/or controlling other speech characteristics. If voices are provided in separate files, the speech synthesizer developer is responsible for providing a method for installing these resources into the System Folder or Extensions folder. The computer must be rebooted after speech synthesizers are added to or removed from the System Folder for the desired changes to be recognized.Speech Manager ConceptsOn a simple level, speech synthesis from text input is a two-stage process. First, plain-language English text is converted into phonemic representations for the individual words. Phonemes stand for specific sounds; for a complete explanation, see “Summary of Phonemes and Prosodic Controls,” later in this document. The resulting sequence of phonemes is converted into audible sounds by mapping of the individual phonemes to a series of waveforms, which are sent to the sound hardware to be played.In reality, each stage is more complicated than this description suggests. For example, during the text-to-phoneme conversion stage, number strings, abbreviations, and special symbols must be detected and converted into appropriate words before being converted into phonemes. When a sentence such as “He earned over $2,000,000 in 1990” is spoken, it would normally be preferable to say “He earned over two million dollars in nineteen- ninety” rather than “He earned over dollar-sign, two, comma, zero, zero, zero, comma, zero, zero, zero, in one, nine, nine, zero.” To produce the desired spoken output automatically, knowledge of these sorts of constructions is built into the synthesizer.The phoneme-to-sound conversion stage is also complex. Phonemes by themselves are often not sufficient to describe the way a word should be pronounced. For example, the word “object” is pronounced differently depending on whether it is used as a noun or a verb. (When it is used as a noun, the stress is placed on the first syllable. As a verb, the stress is placed on the second syllable.) In addition to stress information, phonemes must often be augmented with pitch, duration, and other information to produce intelligible, natural-sounding speech.The speech synthesizer has many built-in rules for automatically converting text into the complex phonemic representation described above. However, there will always be words and phrases that are not pronounced the way you want. The Speech Manager allows you to provide raw phonemic information directly in order to enable very precise control over the spoken output.By default, speech synthesizers expect input in normal language text. However, using the input mode controls of the Speech Manager, you can tell the synthesizer to process input text in raw phonemic form. By using the embedded commands described in the next section, you can even mix normal language text with phonemic text within a single string or text buffer.See “Summary of Phonemes and Prosodic Controls,” later in this document, for a listing of the phonemic character set and each character’s interpretation.Using the Speech ManagerThis section describes the routines used to add speech synthesis features to an application. It is organized into three sections: “Getting Started” (Easy), “Essential Calls—Simple and Useful” (Intermediate), and “Advanced Routines.”Getting StartedIf you’re just getting started with text-to-speech conversion using the Speech Manager, the following routines will get you up and running with minimal effort. If you’re developing an application that does not need to choose voices, use more than one channel of speech, or exercise real-time control over the synthesized speech, these may be the only routines you need.Determining If the Speech Manager Is AvailableYou can find out if the Speech Manager is available with a single call to the Gestalt Manager. Use the Gestalt toolbox routine and the selector gestaltSpeechAttr to determine whether or not the Speech Manager is available, as shown in Listing 1-1. If Gestalt returns noErr, then the parameter argument will contain a 32-bit value indicating one or more attributes of the installed Speech Manager. If the Speech Manager exists, the bit specified by gestaltSpeechMgrPresent is set.Listing 1-1 Determining if the Speech Manager is availableBoolean SpeechAvailable (void) { OSErr err; long result; err = Gestalt(gestaltSpeechAttr, &result); if ((err != noErr) || !(result & (1 << gestaltSpeechMgrPresent))) return FALSE; else return TRUE;}Which Version of the Speech Manager Is Running?Once you have determined that the Speech Manager is installed, you can see which version of the Speech Manager is running by calling SpeechManagerVersion.SpeechManagerVersionReturns the version of the Speech Manager installed in the system.pascal NumVersion SpeechManagerVersion (void);DESCRIPTIONSpeechManagerVersion returns the version of the Speech Manager installed in the system. This call should be used to determine the compatibility of your program with the currently installed Speech Manager.RESULT CODESNoneMaking Some NoiseThe most basic operation of the Speech Manager is accomplished by using the SpeakString call. This call passes a specific text string to be spoken to the Speech Manager.SpeakStringThe SpeakString function passes a specific text string to be spoken to the Speech Manager.pascal OSErr SpeakString (StringPtr myString);Field descriptionsmyString Text string to be spokenDESCRIPTIONSpeakString attempts to speak the Pascal-style text string contained in myString. Speech is produced asynchronously using the default system voice. When an application calls this function, the Speech Manager makes a copy of the passed string and creates any structures required to speak it. As soon as speaking has begun, control is returned to the application. The synthesized speech is generated transparently to the application so that normal processing can continue while the text is being spoken. No further interaction with the Speech Manager is required at this point, and the application is free to release or purge or trash the original string.If SpeakString is called while a prior string is still being spoken, the audio currently being synthesized is interrupted immediately. Conversion of the new text into speech is then initiated. If an empty (zero length) string or a null string pointer is passed to SpeakString, it stops the synthesis of any prior string but does not generate any additional speech.As with all Speech Manager routines that expect text arguments, the text may contain embedded speech control commands. Result CodesnoErr 0 No error memFullErr –108 Not enough memory to speak synthOpenFailed –241 Could not open another speech synthesizer channel Determining If Speaking Is CompleteOnce an application starts a speech process with SpeakString, the next thing it will probably need to know is whether the string has been completely spoken. It can use SpeechBusy to determine whether or not the system is still speaking.SpeechBusyThe SpeechBusy routine is useful when you want to ensure that an earlier speech request has been completed before having the system speak again.pascal short SpeechBusy (void);DESCRIPTIONSpeechBusy returns the number of channels of speech that are currently synthesizing speech in the application. If you use just SpeakString to initiate speech, SpeechBusy will always return 1 as long as speech is being produced. When SpeechBusy returns 0, all initiated speech has finished. RESULT CODESNoneA Simple ExampleThe example shown in Listing 1-2 demonstrates how to use the routines introduced in this section. It first makes sure the Speech Manager is available. Then it starts speaking a string (hard-coded in this example, but more commonly loaded from a resource) and loops, doing some screen drawing, until the string is completely spoken. This example uses the SpeechAvailable routine shown in Listing 1-1.Listing 1-2 Elementary Speech Manager callsOSErr err;if (SpeechAvailable()) { err = SpeakString("\pThe cat sat on the mat."); if (err == noErr) while (SpeechBusy() > 0) CoolAnimationRoutine(); else NotSoCoolAlertRoutine(err);}Essential Calls—Simple and UsefulWhile the routines presented in the last section are simple to use, their applicability is limited to a few basic speech scenarios. This section describes additional routines that let you work with different voices and adjust some basic characteristics of the synthesized speech.Working With VoicesWhen describing a person’s voice, we talk about the particular set of characteristics that help us to distinguish that person’s voice from another. For example, the rate at which one speaks (slow or fast) and the average pitch (high or low) characterize a particular speaker on a crude level. In the context of the Speech Manager, a voice is the set of parameters that specify a particular quality of synthesized speech. This portion of the Speech Manager is used to determine which voices are available and to select particular voices.Every specific voice has a unique ID associated with it, which is the primary way an application refers to it. Within the Speech Manager a unique voice ID is called a VoiceSpec structure.The Speech Manager provides two routines to count and step through the list of currently available voices. CountVoices is used to compute how many voices are available with the current system. GetIndVoice uses an index, starting at 1, to return information about all currently installed voices.Use the GetIndVoice routine to step through the list of available voices. It will fill a VoiceSpec record that can be used to obtain descriptive information about the voice or to speak using that voice.Any application that wishes to use multiple voices will probably need additional information about the available voices beyond the VoiceSpec structure, such as the name of the voice and perhaps what script and language each voice supports. This information might be presented to the user in a “voice picker” dialog box or voice menu, or it might be used internally by an application trying to find a voice that meets certain criteria. Applications can use the GetVoiceDescription routine for these purposes.MakeVoiceSpecTo maximize compatibility with future versions of the Speech Manager, you should always use MakeVoiceSpec instead of setting the fields of the VoiceSpec structure directly.pascal OSErr MakeVoiceSpec (OSType creator, OSType id, VoiceSpec *voice);typedef struct VoiceSpec { OSType creator; // determines which synthesizer is required OSType id; // voice ID on the specified synth } VoiceSpec;Field descriptionscreator The synthesizer required by your applicationid Identification number for this voice*voice Pointer to the VoiceSpec structureDESCRIPTIONMost voice management routines expect to be passed a pointer to a VoiceSpec structure. MakeVoiceSpec is a utility routine provided to facilitate the creation of VoiceSpec records. On return, the passed VoiceSpec structure contains the appropriate values.Voices are stored in resources of type 'ttsv' in the resource fork of Macintosh files. The Speech Manager uses the same search method as the Resource Manager, looking for voice resources in three different locations when attempting to resolve VoiceSpec references. It first looks in the application’s resource file chain. If the specified voice is not found in an open file, it then looks in the System Folder and the Extensions folder (or in just the System Folder under System 6) for files of type 'ttsv' (single-voice files) or 'ttsb' (multivoice files) and in text-to-speech synthesizer component files (file type 'INIT' or 'thng'). Voices stored in the System Folder or Extensions folder are normally available to all applications. Voices stored in the resource fork of an application files are private to the application.RESULT CODEnoErr 0 No error While the determination of specific voice ID values is mostly left to synthesizer developers, the voice creator values are specified by Apple (they would ordinarily correspond to a developer’s currently assigned creator ID). For both the creator and id fields Apple further reserves the set of OSType values specified entirely by space characters and lowercase letters. Apple is establishing a standard suite of voice ID values that developers can count upon being available with all speech synthesizers.CountVoicesThe CountVoices routine returns the number of voices available.pascal OSErr CountVoices (short *voiceCount);Field descriptionsvoiceCount Number of voices available to the applicationDESCRIPTIONEach time CountVoices is called, the Speech Manager searches for new voices. This algorithm supports dynamic installation of voices by applications or users. On return, the voiceCount parameter contains the number of voices available.RESULT CODESnoErr 0 No error GetIndVoiceThe GetIndVoice routine returns information about a specific voice.pascal OSErr GetIndVoice (short index, VoiceSpec *voice);Field descriptionsindex Index value for a specific voice*voice Pointer to the VoiceSpec structureDESCRIPTIONAs with all other index-based routines in the Macintosh Toolbox, an index value of 1 causes GetIndVoice to return information for the first voice. The order that voices are returned is not presently defined and should not be assumed. Speech Manager behavior when voice files or resources are added, removed, or modified is also presently undefined. However, calling CountVoices or GetIndVoice with an index of 1 will force the Speech Manager to update its list of available voices. GetIndVoice will return a voiceNotFound error if the passed index value exceeds the number of available voices.RESULT CODESnoErr 0 No error voiceNotFound –244 Voice resource not found GetVoiceDescriptionThe GetVoiceDescription routine returns information about a voice beyond that provided by GetIndVoice.pascal OSErr GetVoiceDescription (VoiceSpec *voice, VoiceDescription *info, long infoLength);enum {kNeuter = 0, kMale, kFemale}; // returned in gender field below typedef struct VoiceDescription { long length; // size of structure VoiceSpec voice; // synth and ID info for voice long version; // version code for voice Str63 name; // name of voice Str255 comment; // additional text info about voice short gender; // neuter, male, or female short age; // approximate age in years short script; // script code of text voice can process short language; // language code of voice output speech short region; // region code of voice output speech long reserved[4]; // always zero - reserved } VoiceDescription;Field descriptions*voice Pointer to the VoiceSpec structure*info Pointer to structure containing parameters for the specified voiceinfoLength Length in bytes of info structureDESCRIPTIONThe Speech Manager fills out the passed VoiceDescription fields with the correct information for the specified voice. If a null VoiceSpec pointer is passed, the Speech Manager returns information for the system default voice. If the VoiceDescription pointer is null, the Speech Manager simply verifies that the specified VoiceSpec refers to an available voice. If VoiceSpec does not refer to a known voice, GetVoiceDescription returns a voiceNotFound error, as shown in Listing 1-3.To maximize compatibility with future versions of the Speech Manager, the application must pass the size of the VoiceDescription structure. Having the application do this ensures that the Speech Manager will never write more data into the passed structure than will fit even if additional information fields are defined in the future. On returning from GetVoiceDescription, the length field is set to reflect the length of data actually written by this routine.Listing 1-3 Getting information about a voiceOSErr GetVoiceGender (VoiceSpec *voicePtr, short *gender) { OSErr err; VoiceDescription vd; err = GetVoiceDescription (voicePtr,&vd,sizeof(VoiceDescription)); if (err == noErr) { if (vd.length > offsetof(VoiceDescription,gender)) *gender = vd.gender; else err = badStructLen; } return err;}RESULT CODESnoErr 0 No error paramErr –50 Parameter error memFullErr –108 Not enough memory to load voice into memory voiceNotFound –244 Voice resource not found Managing Connections to Speech SynthesizersUsing the routines described earlier in this document, an application can select the voice with which to speak. The next step is to associate the selected voice with the proper speech synthesizer. This is accomplished by creating a new speech channel with the NewSpeechChannel routine. A speech channel is a private communication connection to the speech synthesizer, much as a file reference number is a communication channel to an open file in the Macintosh file system.The DisposeSpeechChannel routine closes a speech channel when the application is finished with it and releases any resources that have been allocated to support the speech synthesizer and are no longer needed.NewSpeechChannelThe NewSpeechChannel routine creates a new speech channel.pascal OSErr NewSpeechChannel (VoiceSpec *voice, SpeechChannel *chan);Field descriptions*voice Pointer to the VoiceSpec structure*chan Pointer to the new channelDESCRIPTIONThe Speech Manager automatically locates and opens a connection to the proper synthesizer for a specified voice and sets up a channel at the location pointed to by *chan so that it is ready to speak with that voice. If a null VoiceSpec pointer is passed to NewSpeechChannel, the Speech Manager uses the current system default voice.There is no predefined limit to the number of speech channels an application may create. However, system constraints on available RAM, processor loading, and number of available sound channels may limit the number of speech channels actually possible.RESULT CODESnoErr 0 No error memFullErr –108 Not enough memory to open speech channel synthOpenFailed –241 Could not open another speech synthesizer channel voiceNotFound –244 Voice resource not found DisposeSpeechChannelThe DisposeSpeechChannel routine disposes of an existing speech channel.pascal OSErr DisposeSpeechChannel (SpeechChannel chan);Field descriptionschan Specific speech channelDESCRIPTIONThis routine disposes of an existing speech channel. Any speech channels that have not been explicitly disposed of by the application are released automatically by the Speech Manager when the application quits.RESULT CODESnoErr 0 No error invalidComponentID –3000 Invalid SpeechChannel parameter Starting and Stopping SpeechAll the remaining routines in this section require a valid speech channel to work properly. Once the application has successfully created a speech channel, it can start to speak. You use the SpeakText routine to begin speaking on a speech channel.At any time during the speaking process, the application can stop the synthesizer’s speech. The StopSpeech routine will immediately abort any speech being produced on the specified speech channel and force the channel back into an idle state.SpeakTextThe SpeakText routine converts a designated text into speech.pascal OSErr SpeakText (SpeechChannel chan, Ptr textBuf, long byteLength);Field descriptionschan Specific speech channeltextBuf Buffer of textbyteLength Length of textBufDESCRIPTIONIn addition to a valid speech channel, SpeakText expects a pointer to the text to be spoken and the length in bytes of the text buffer. SpeakText will convert the given text stream into speech using the voice and control settings for that speech channel. The speech is generated asynchronously. This means that control is returned to your application before the speech has finished (probably even before it has begun). The maximum length of text buffer that can be spoken is limited only by the available RAM. However, it’s generally not very friendly to force the user to listen to long uninterrupted text unless the user requests it. If SpeakText is called while it is currently busy speaking the contents of a prior text buffer, it will immediately stop speaking from the prior buffer and will begin speaking from the new text buffer as soon as possible. As with SpeakString, described on page 5, if an empty (zero length) string or a null text buffer pointer is passed to SpeakText, this will have the effect of stopping the synthesis of any prior text but will not generate any additional speech.sWARNINGWith SpeakText, unlike with SpeakString, the text buffer must be locked in memory and must not move during the entire time that it is being converted into speech. This buffer is read at interrupt time, and very undesirable effects will happen if it moves or is purged from memory.sRESULT CODESnoErr 0 No error invalidComponentID –3000 Invalid SpeechChannel parameter StopSpeechThe StopSpeech routine terminates speech delivery on a specified channel.pascal OSErr StopSpeech (SpeechChannel chan);Field descriptionschan Specific speech channelDESCRIPTIONAfter returning from StopSpeech, the application can safely release any text buffer that that the speech synthesizer has been using. The SpeechBusy routine, described on page 6, can be used to determine if the text has been completely spoken. (In an environment with multiple speech channels, you may need to use the more advanced status routine GetSpeechInfo, described on page 25, to determine if a specific channel is still speaking.) StopSpeech can be called for an already idle channel without ill effect. RESULT CODESnoErr 0 No error invalidComponentID –3000 Invalid SpeechChannel parameter Using Basic Speech ControlsThe Speech Manager provides several methods of adjusting the variables that can affect the way speech is synthesized. Although most applications probably do not need to use these advanced features, two of the speech variables, speaking rate and speaking pitch, are useful enough that a very simple way of adjusting these parameters on a channel-by-channel basis is provided. Routines are supplied that enable an application to both set and get these parameters. However, the audible effects of changing the rate and pitch of speech vary from synthesizer to synthesizer; you should test the actual results on all synthesizers with which your application may work.Speaking rates are specified in terms of words per minute (WPM). While this unit of measurement is difficult to define in any precise way, it is generally easy to understand and use. The range of supported rates is not predefined by the Speech Manager. Each speech synthesizer provides its own range of speaking rates. Furthermore, any specific rate value will correspond to slightly different rates with different synthesizers. Speaking pitches are defined on a musical scale that corresponds to the keys on a standard piano keyboard. By convention, pitches are represented as fixed-point values in the range from 0.000 through 100.000, where 60.000 corresponds to middle C (261.625 Hz) on a conventional piano. Pitches are represented on a logarithmic scale. On this scale, a change of +12 units corresponds to doubling the frequency, while a change of –12 units corresponds to halving the frequency. For a further discussion of pitch values, see “Getting Information About a Speech Channel,” later in this document.Typical voice frequencies might range from around 90 Hertz for a low-pitched male voice to perhaps 300 Hertz for a high-pitched child’s voice. These frequencies correspond to pitch values of 41.526 and 53.526, respectively.Changes in speech rate and pitch are effective immediately (as soon as the synthesizer can respond), even if they occur in the middle of a word.SetSpeechRateThe SetSpeechRate routine sets the speaking rate on a designated speech channel.pascal OSErr SetSpeechRate (SpeechChannel chan, Fixed rate);Field descriptionschan Specific speech channelrate Word output speaking rateDESCRIPTIONThe SetSpeechRate routine is used to adjust the speaking rate on a speech channel. The rate parameter is specified as a fixed-point, words per minute value. As a general rule of thumb, “normal” speaking rates range from around 150 WPM to around 180 WPM. It is important when working with speaking rates, however, to keep in mind that users will differ greatly in their ability to understand synthesized speech at a particular rate based upon their level of experience listening to the voice and their ability to anticipate the types of utterances they will encounter.RESULT CODESnoErr 0 No error invalidComponentID –3000 Invalid SpeechChannel parameter GetSpeechRateThe GetSpeechRate routine returns the speech rate currently active on a designated speech channel.pascal OSErr GetSpeechRate (SpeechChannel chan, Fixed *rate);Field descriptionschan Specific speech channel*rate Pointer to the current speaking rateDESCRIPTIONThe GetSpeechRate routine is used to find out the speaking rate currently active on a speech channel.RESULT CODESnoErr 0 No error invalidComponentID –3000 Invalid SpeechChannel parameter SetSpeechPitchThe SetSpeechPitch routine sets the speaking pitch on a designated speech channel.pascal OSErr SetSpeechPitch (SpeechChannel chan, Fixed pitch);Field descriptionschan Specific speech channelpitch Frequency of voiceDESCRIPTIONUse the SetSpeechPitch routine to change the current speaking pitch on a speech channel.RESULT CODESnoErr 0 No error invalidComponentID –3000 Invalid SpeechChannel parameter GetSpeechPitchThe GetSpeechPitch routine returns the current speaking pitch on a designated speech channel.pascal OSErr GetSpeechPitch (SpeechChannel chan, Fixed *pitch);Field descriptionschan Specific speech channelpitch Frequency of voiceDESCRIPTIONThe GetSpeechPitch routine is used to find out the speaking pitch currently active on a speech channel.RESULT CODESnoErr 0 No error invalidComponentID –3000 Invalid SpeechChannel parameter Putting It All TogetherThe code fragment in Listing 1-4 illustrates many of the routines introduced in this section. The example steps through the list of available voices to find the first female voice. Then it creates a new speech channel and begins speaking. While the voice is speaking, the pitch of the voice is continually adjusted around the original pitch. If the mouse button is pressed while the voice is speaking, the code halts the speech and exits. This example uses the SpeechAvailable and GetVoiceGender routines shown earlier in Listing 1-1 and Listing 1-3.Listing 1-4 Putting it all togetherOSErr err;Str255 myStr = "\pThe bat sat on my hat.";VoiceSpec voice;VoiceDescription vd;Boolean gotVoice = FALSE;short voiceCount, gender, i;SpeechChannel chan;Fixed origPitch, newPitch;if (myStr[0] && SpeechAvailable()) { err = CountVoices(&voiceCount); // count the available voices i = 1; while ((i <= voiceCount) && ((err=GetIndVoice(i++, &voice)) ==noErr)) { err = GetIndVoice(i++, &voice)) == noErr; err = GetVoiceGender(&voice, &gender); if ((err == noErr) && (gender == kFemale)) { gotVoice = TRUE; break; } } if (gotVoice) { err = NewSpeechChannel(&voice, &chan); if (err == noErr) { err = GetSpeechPitch(chan, &origPitch); // cur pitch if (err == noErr) err = SpeakText(chan, &myStr[1], myStr[0]); i = 0; if (err == noErr) while (SpeechBusy() > 0) { CoolAnimationRoutine(); newPitch = (i - 4) << 16; // fixed pitch offset newPitch += origPitch; i = (i + 1) & 7; // steps from 0 to 7 repeatedly err = SetSpeechPitch(chan, newPitch); if ((err != noErr) || Button()) { err = StopSpeech(chan); break; } } err = DisposeSpeechChannel(chan); } } if (err != noErr) NotSoCoolAlertRoutine(err);Advanced RoutinesThis section describes several advanced or rarely-used Speech Manager routines. You can use them to improve the quality of your application’s speech.Advanced Speech ControlsThe StopSpeech routine, described in “Starting and Stopping Speech,” earlier in this document, provides a simple way to interrupt any speech output instantly. In some situations it is preferable to be able to stop speech production at the next natural boundary, such as the next word or the end of the current sentence. StopSpeechAt provides that capability.Similarly, the PauseSpeechAt routine causes speech to pause at a specified point in the text being spoken; the ContinueSpeech routine resumes speech after it has paused.In addition to SpeakString and SpeakText, described earlier in this document, the Speech Manager provides a third, more general routine. SpeakBuffer is the low-level speech routine upon which the other two are built. SpeakBuffer provides greater control through the use of an additional flags parameter.The SpeechBusySystemWide routine tells you if any speech is currently being synthesized in your application or elsewhere on the computer.StopSpeechAtThe StopSpeechAt routine halts speech at a specific point in the text being spoken.pascal OSErr StopSpeechAt (SpeechChannel chan, long whereToStop);enum { kImmediate = 0, kEndOfWord = 1, kEndOfSentence = 2};Field descriptionschan Specific speech channelwhereToStop Location in text at which speech is to stop DESCRIPTIONStopSpeechAt is used to halt the production of speech at a specified point in the text. The whereToStop argument should be set to one of the following constants:n The kImmediate constant stops speech output immediately. n The kEndOfWord constant lets speech continue until the current word has been spoken. n The kEndOfSentence constant lets speech continue until the end of the current sentence has been reached. This routine returns immediately, although speech output continues until the specified point has been reached.sWARNINGYou must not release the memory associated with the current text buffer until the channel status indicates that the speech channel output is no longer busy.sIf the end of the input text buffer is reached before the specified stopping point, the speech synthesizer will stop at this point. Once the stopping point has been reached, the application is free to release the text buffer. Calling StopSpeechAt with whereToStop equal to kImmediate is equivalent to calling StopSpeech, described on page 14. Contrast the StopSpeechAt routine with PauseSpeech, described next.RESULT CODESnoErr 0 No error invalidComponentID –3000 Invalid SpeechChannel parameter PauseSpeechAtThe PauseSpeechAt routine causes speech to pause at a specified point in the text being spoken.pascal OSErr PauseSpeechAt (SpeechChannel chan, long whereToPause);enum { kImmediate = 0, kEndOfWord = 1, kEndOfSentence = 2};Field descriptionschan Specific speech channelwhereToPause Location in text at which speech is to pause DESCRIPTIONPauseSpeech makes speech production pause at a specified point in the text. The whereToPause parameter should be set to one of these constants: n The kImmediate constant stops speech output immediately. n The kEndOfWord constant lets speech continue until the current word has been spoken. n The kEndOfSentence constant lets speech continue until the end of the current sentence has been reached. When the specified point is reached, the speech channel enters the paused state, reflected in the channel’s status. PauseSpeechAt returns immediately, although speech output will continue until the specified point.If the end of the input text buffer is reached before the specified pause point, speech output pauses at the end of the buffer.PauseSpeechAt differs from StopSpeech and StopSpeechAt in that a subsequent call to ContinueSpeech, described next, causes the contents of the current text buffer to continue being spoken.sWARNINGWhile in a paused state, the last text buffer must remain available at all times and must not move. While paused, the SpeechChannel status indicates outputBusy = true and outputPaused = true.sRESULT CODESnoErr 0 No error invalidComponentID –3000 Invalid SpeechChannel parameter ContinueSpeechThe ContinueSpeech routine resumes speech after it has been halted by the PauseSpeechAt routine.pascal OSErr ContinueSpeech (SpeechChannel chan);Field descriptionschan Specific speech channelDESCRIPTIONAt any time after PauseSpeechAt is called, ContinueSpeech may be called to continue speaking from the point at which speech paused. Calling ContinueSpeech on a channel that is not currently in a pause state has no effect; calling it before a pause is effective cancels the pause.RESULT CODESnoErr 0 No error invalidComponentID –3000 Invalid SpeechChannel parameter SpeakBufferThe SpeakBuffer routine causes the contents of a text buffer to be spoken, using certain flags to control speech behavior.pascal OSErr SpeakBuffer (SpeechChannel chan, Ptr textBuf, long byteLength, long controlFlags);enum { kNoEndingProsody = 1, kNoSpeechInterrupt = 2, kPreflightThenPause = 4};Field descriptionschan Specific speech channeltextBuf Buffer of textbyteLength Length of textBufcontrolFlags Control flags to control speech behavior DESCRIPTIONWhen the controlFlags parameter is set to 0, SpeakBuffer behaves identically to SpeakText, described on page 13.The kNoEndingProsody flag bit is used to control whether or not the speech synthesizer automatically applies ending prosody, the speech tone and cadence that normally occur at the end of a statement. Under normal circumstances (for example, when the flag bit is not set), ending prosody is applied to the speech when the end of the textBuf data is reached. This default behavior can be disabled by setting the kNoEndingProsody flag bit.Some synthesizers do not speak until the kNoEndingProsody flag bit is reset, or they encounter a period in the text, or textBuf is full. The kNoSpeechInterrupt flag bit is used to control the behavior of SpeakBuffer when called on a speech channel that is still busy. When the flag bit is not set, SpeakBuffer behaves similarly to SpeakString and SpeakText, described earlier in this document. Any speech currently being produced on the specified speech channel is immediately interrupted and then the new text buffer is spoken. When the kNoSpeechInterrupt flag bit is set, however, a request to speak on a channel that is still busy processing a prior text buffer will result in an error. The new buffer is ignored and the error synthNotReady is returned. If the prior text buffer has been fully processed, the new buffer is spoken normally. The kPreflightThenPause flag bit is used to minimize the latency experienced when attempting to speak. Ordinarily whenever a call to SpeakString, SpeakText, or SpeakBuffer is made, the speech synthesizer must perform a certain amount of initial processing before speech output is heard. This startup latency can vary from a few milliseconds to several seconds depending upon which speech synthesizer is being used. Recognizing that larger startup delays may be detrimental to certain applications, a mechanism is provided to provide the synthesizer a chance to perform any necessary computations at noncritical times. Once the computations have been completed, the speech is able to start instantly. When the kPreflightThenPause flag bit is set, the speech synthesizer will process the input text as necessary to the point where it is ready to begin producing speech output. At this point, the synthesizer will enter a paused state and return to the caller. When the application is ready to produce speech, it should call the ContinueSpeech routine to begin speaking.RESULT CODESnoErr 0 No error synthNotReady –242 Speech channel is still busy speaking invalidComponentID –3000 Invalid SpeechChannel parameter SpeechBusySystemWideYou can use SpeechBusySystemWide to determine if any speech is currently being synthesized in your application or elsewhere on the computer.pascal short SpeechBusySystemWide (void);DESCRIPTIONThis routine is useful when you want to ensure that no speech is currently being produced anywhere on the Macintosh computer. SpeechBusySystemWide returns the total number of speech channels currently synthesizing speech on the computer, whether they were initiated by your code or by some other process executing concurrently.RESULT CODESNoneConverting Text Into PhonemesIn some situations it is desirable to convert a text string into its equivalent phonemic representation. This may be useful during the content development process to fine-tune the pronunciation of particular words or phrases. By first converting the target phrase into phonemes, you can see what the synthesizer will try to speak. Then you need only correct the parts that would not have been spoken the way you want.TextToPhonemesThe TextToPhonemes routine converts a designated text to phoneme codes.pascal OSErr TextToPhonemes (SpeechChannel chan, Ptr textBuf, long textBytes, Handle phonemeBuf, long *phonemeBytes);Field descriptionschan Specific speech channeltextBuf Buffer of texttextBytes Length of textBuf in bytesphonemeBuf Buffer of phonemes*phonemeBytes Pointer to length of phonemeBuf in bytesDESCRIPTIONIt may be useful to convert your text into phonemes during application development in order to be able to reduce the amount of memory required to speak. If your application does not require the text-to-phoneme conversion portion of the speech synthesizer, significantly less RAM may be required to speak with some synthesizers. Additionally, you may be able to use a higher quality text-to-phoneme conversion process (even one that does not work in real time) to generate precise phonemic information. This data can then be used with any speech synthesizer to produce better speech.TextToPhonemes accepts a valid SpeechChannel parameter, a pointer to the characters to be converted into phonemes, the length of the input text buffer in bytes, an application-supplied handle into which the converted phonemes can be written, and a length parameter. On return, the phonemeBytes argument is set to the number of phoneme character bytes that were written into phonemeBuf. The data returned by TextToPhonemes will correspond precisely to the phonemes that would be spoken had the input text been sent to SpeakText instead. All current mode settings are applied to the converted speech. No callbacks are generated while the TextToPhonemes routine is generating its output.RESULT CODESnoErr 0 No error paramErr –50 Parameter value is invalid nilHandleErr –109 Handle argument is nil siUnknownInfoType –231 Feature not implemented on synthesizer invalidComponentID –3000 Invalid SpeechChannel parameter Getting Information About a Speech ChannelSeveral additional types of information have been made available for advanced users of the Speech Manager. This information provides more detailed status information for each channel. You can get this information by calling the GetSpeechInfo routine. This function accepts selectors that determine the type of information you want to get.NoteThroughout this document, there are several references to parameter values specified with fixed-point integer values (pbas, pmod, rate, and volm). Unless otherwise stated, the full range of values of the Fixed data type is valid. However, it is left to the individual speech synthesizer implementation to determine whether or not to use the full resolution and range of the Fixed data type. In the event a specified parameter value lies outside the range supported by a particular synthesizer, the synthesizer will substitute the value closest to the specified value that does lie within its performance specifications.uGetSpeechInfoThe GetSpeechInfo routine returns information about a designated speech channel.pascal OSErr GetSpeechInfo (SpeechChannel chan, OSType selector, void *speechInfo);enum {soStatus = 'stat', // gets speech output status soErrors = 'erro', // gets error status soInputMode = 'inpt', // gets current text/phon mode soCharacterMode = 'char', // gets current character mode soNumberMode = 'nmbr', // gets current number mode soRate = 'rate', // gets current speaking rate soPitchBase = 'pbas', // gets current baseline pitch soPitchMod = 'pmod', // gets current pitch modulation soVolume = 'volm', // gets current speaking volume soSynthType = 'vers', // gets speech synth version info soRecentSync = 'sync', // gets most recent sync message info soPhonemeSymbols = 'phsy', // gets phoneme symbols & ex. words soSynthExtension = 'xtnd' // gets synthesizer-specific info };Field descriptionschan Specific speech channelselector Used to specify data being requested*speechInfo Pointer to an information structureDESCRIPTIONThe following list of selectors describes the various types of information that can be obtained from the Speech Manager. The format of the information returned depends on which value is used in the selector field, as follows:NoteFor future code compatibility, use the application programming interface (API) labels instead of literal selector values.uField descriptionsstat Gets various items of status information for the specified channel. Indicates whether any speech audio is being generated, whether or not the channel has paused, how many bytes in the input text have yet to be processed, and the phoneme code for the phoneme that is currently being generated. If inputBytesLeft is 0, the input buffer is no longer needed and can be disposed of. The API label for this selector is soStatus. typedef SpeechStatusInfo *speechInfo; typedef struct SpeechStatusInfo { Boolean outputBusy; // true = audio playing Boolean ouputPaused; // true = channel paused long inputBytesLeft; // bytes left to process short phonemeCode; // current phoneme code } SpeechStatusInfo;erro Gets saved error information and clears the error registers. This selector lets you poll for various run-time errors that occur during speaking, such as the detection of badly formed embedded commands. Errors returned directly by Speech Manager routines are not reported here. The count field shows how many errors have occurred since the last check. If count is 0 or 1, then oldest and newest will be the same. Otherwise, oldest contains the error code for the oldest unread error and newest contains the error code for the most recent error. Both oldPos and newPos contain the character positions of their respective errors in the original input text buffer. The API label for this selector is soErrors. typedef SpeechErrorInfo *speechInfo; typedef struct SpeechErrorInfo { short count; // # of errs since last check OSErr oldest; // oldest unread error long oldPos; // char position of oldest err OSErr newest; // most recent error long newPos; // char position of newest err } SpeechErrorInfo;inpt Gets the current value of the text processing mode control. The returned value specifies whether the specified speech channel is currently in text-input mode (TEXT) or phoneme-input mode (PHON). The API label for this selector is soInputMode. typedef OSType *speechInfo; // TEXT or PHONchar Gets the current value of the character processing mode control. The returned value specifies whether the specified speech channel is currently processing input characters in normal mode (NORM) or in literal, letter-by-letter, mode (LTRL). The API label for this selector is soCharacterMode. typedef OSType *speechInfo; // NORM or LTRL nmbr Gets the current value of the number processing mode control. The returned value specifies whether the specified speech channel is currently processing input character digits in normal mode (NORM) or in literal, digit-by-digit, mode (LTRL). The API label for this selector is soNumberMode. typedef OSType *speechInfo; // NORM or LTRL rate Gets the current speaking rate in words per minute on the specified channel. Speaking rates are fixed-point values. The API label for this selector is soRate. typedef Fixed *speechInfo;NoteWords per minute is a convenient, if difficult to define, way of representing speaking rate. Although there is no universally accepted definition of words per minute, it does communicate approximate information about speaking rates. Any specific rate may correspond to different rates on different synthesizers, but the two rates should be reasonably close. More importantly, doubling the rate on a particular synthesizer should halve the time needed to speak any particular utterance.upbas Gets the current baseline pitch for the specified channel. The pitch value is a fixed-point integer that conforms to the following frequency relationship: Hertz = 440.0 * 2((BasePitch - 69) / 12) BasePitch of 1.0 ≈ 9 Hertz BasePitch of 39.5 ≈ 80 Hertz BasePitch of 45.8 ≈ 115 Hertz BasePitch of 50.4 ≈ 150 Hertz BasePitch of 100.0 ≈ 2637 HertzBasePitch values are always positive numbers in the range from 1.0 through 100.0. The API label for this selector is soPitchBase. typedef Fixed *speechInfo;pmod Gets the current pitch modulation range for the speech channel. Modulation values range from 0.0 through 100.0. A value of 0.0 corresponds to no modulation and means the channel will speak in a monotone. The API label for this selector is soPitchMod. Nonzero modulation values correspond to pitch and frequency deviations according to the following formula: Maximum pitch = BasePitch + PitchMod Minimum pitch = BasePitch - PitchMod Maximum Hertz = BaseHertz * 2(+ ModValue / 12) Minimum Hertz = BaseHertz * 2(- ModValue / 12) Given: BasePitch of 46.0 (≈ 115 Hertz), PitchMod of 2.0, Then: Maximum pitch = 48.0 (≈131 Hertz), Minimum pitch = 44.0 (≈104 Hertz) typedef Fixed *speechInfo;volm Gets the current setting of the volume control on the specified channel. Volumes are expressed in fixed-point units ranging from 0.0 through 1.0. A value of 0.0 corresponds to silence, and a value of 1.0 corresponds to the maximum possible volume. Volume units lie on a scale that is linear with amplitude or voltage. A doubling of perceived loudness corresponds to a doubling of the volume. The API label for this selector is soVolume. typedef Fixed *speechInfo;vers Gets descriptive information for the type of speech synthesizer being used on the specified speech channel. The API label for this selector is soSynthType. typedef SpeechVersionInfo *speechInfo; typedef struct SpeechVersionInfo { OSType synthType; // always 'ttsc' OSType synthSubType; // synth flavor OSType synthManufacturer; // synth creator long synthFlags; // reserved NumVersion synthVersion; // synth version } SpeechVersionInfo;sync Returns the sync message code for the most recently encountered embedded sync command at the audio output point. If no sync command has been encountered, 0 is returned. Refer to the section “Embedded Speech Commands,” later in this document, for information about sync commands. The API label for this selector is soRecentSync. typedef OSType *speechInfo;phsy Returns a list of phoneme symbols and example words defined for the current synthesizer. The input parameter is the address of a handle variable. On return, the PhonemeDescriptor parameter contains a handle to the array of phoneme definitions. Make sure to dispose of the handle when you are done using it. This information is normally used to indicate to the user the approximate sounds corresponding to various phonemes—an important feature in international speech. The API label for this selector is soPhonemeSymbols. typedef PhonemeDescriptor ***speechInfo; // VAR Handle typedef struct PhonemeInfo { short opcode; // opcode for the phoneme Str15 phStr; // corresponding char string Str31 exampleStr; // word that shows use of // phoneme short hiliteStart; // part of example word // to be hilighted as in short hiliteEnd; // TextEdit selections } PhonemeInfo; typedef struct PhonemeDescriptor { short phonemeCount; // # of elements PhonemeInfo thePhonemes[1]; // element list } PhonemeDescriptor;xtnd This call supports a general method for extending the functionality of the Speech Manager. It is used to get synthesizer-specific information. The format of the returned data is determined by the specific synthesizer queried. The speechInfo argument should be a pointer to the proper data structure. If a particular synthCreator value is not recognized by the synthesizer, the command is ignored and the siUnknownInfoType code is returned. The API label for this selector is soSynthExtension. typedef SpeechXtndData *speechInfo; typedef struct SpeechXtndData { OSType synthCreator; // synth creator ID Byte synthData[2]; // data TBD by synth } SpeechXtndData;RESULT CODESnoErr 0 No error siUnknownInfoType –231 Feature is not implemented on synthesizer invalidComponentID –3000 Invalid SpeechChannel parameter Advanced Control RoutinesThe Speech Manager provides numerous control features for sophisticated developers. These controls enable you to set various speaking parameters programmatically and provide a rich set of callback routines that can be used to notify applications of various conditions within the speaking process. They are extended by many speech synthesizers.These controls are accessed with the SetSpeechInfo routine. All calls to this routine expect a SpeechChannel parameter, a selector to indicate the desired function, and a pointer to some data. The format of this data depends on the particular selector and is documented in the following routine description.SetSpeechInfoThe SetSpeechInfo routine sets information for a designated speech channel.pascal OSErr SetSpeechInfo (SpeechChannel chan, OSType selector, void *speechInfo);enum { // Sets the parameter: soInputMode = 'inpt', // current text/phon mode soCharacterMode = 'char', // current character mode soNumberMode = 'nmbr', // current number mode soRate = 'rate', // current speaking rate soPitchBase = 'pbas', // current baseline pitch soPitchMod = 'pmod', // current pitch modulation soVolume = 'volm', // current speaking volume soCurrentVoice = 'cvox', // current speaking voice soCommandDelimiter = 'dlim', // command delimiters soReset = 'rset', // re channel to default state soCurrentA5 = 'myA5', // app's A5 on callbacks soRefCon = 'refc', // reference constant soTextDoneCallBack = 'tdcb', // text done callback proc soSpeechDoneCallBack = 'sdcb', // end-of-speech callback proc soSyncCallBack = 'sycb', // sync command callback proc soErrorCallBack = 'ercb', // error callback proc soPhonemeCallBack = 'phcb', // phoneme callback proc soWordCallBack = 'wdcb', // word callback proc soSynthExtension = 'xtnd' // synthesizer-specific info };Field descriptionschan Specific speech channelselector Used to specify data being requested*speechInfo Pointer to an information structureDESCRIPTIONThe following list of selectors outlines the controls available with the Speech Manager. The format of the information returned depends on which value is used in the selector field, as follows:NoteThe Speech Manager supports several callback features that can provide the sophisticated developer with a tight coupling to the speech synthesis process. However, these callbacks must be used carefully. Each is invoked from interrupt level. This means that you may not perform any operations that might cause memory to be allocated, purged, or moved. Although application global variables are also ordinarily not accessible at interrupt time, the soCurrentA5 myA5 selector described in the following text can be used to ask the Speech Manager to point register A5 at your application’s global variables prior to each callback. This makes it fairly painless to access global variables from your callback handlers. If this information worries you, don’t despair. Most information available through callbacks is also available through a GetSpeechInfo call. These calls are more friendly and do not come with the constraints imposed upon callback code. The only drawback is that if you do not poll the information you are interested in often enough, you may miss some of the changes in your speech channel’s status.uField descriptionsinpt Sets the current value of the text processing mode control. The passed value specifies whether the speech channel should be in text-input mode (TEXT) or phoneme-input mode (PHON). Input mode changes take effect as soon as possible; however, the precise latency is dependent upon the specific speech synthesizer. The API label for this selector is soInputMode. typedef OSType *speechInfo; // TEXT or PHON char Sets the current value of the character processing mode control. The passed value specifies whether the speech channel should be in normal character processing mode (NORM) or literal, letter-by-letter, mode (LTRL). Character mode changes take effect as soon as possible; however, the precise latency is dependent upon the specific speech synthesizer. The API label for this selector is soCharacterMode. typedef OSType *speechInfo; // NORM or LTRL nmbr Sets the current value of the number processing mode control. The passed value specifies whether the specified speech channel should be in normal number processing mode (NORM) or in literal, digit-by-digit, mode (LTRL). The number mode changes take effect as soon as possible. However, the precise latency is dependent upon the specific speech synthesizer. The API label for this selector is soNumberMode. typedef OSType *speechInfo; // NORM or LTRL rate Sets the speaking rate in words per minute on the specified channel. Speaking rates are fixed-point values. All values are valid; however, specific synthesizers will not necessarily be able to speak at all possible rates. The API label for this selector is soRate. typedef Fixed *speechInfo;pbas Changes the current baseline pitch for the specified channel. The pitch value is a fixed-point integer that conforms to the following frequency relationship: Hertz = 440.0 * 2((BasePitch - 69) / 12) BasePitch of 1.0 ≈ 9 Hertz BasePitch of 39.5 ≈ 80 Hertz BasePitch of 45.8 ≈ 115 Hertz BasePitch of 50.4 ≈ 150 Hertz BasePitch of 100.0 ≈ 2637 Hertz BasePitch values are always positive numbers in the range from 1.0 through 100.0. typedef Fixed *speechInfo; The API label for this selector is soPitchBase.pmod Changes the current pitch modulation range for the speech channel. Modulation values range from 0.0 through 100.0. A value of 0.0 corresponds to no modulation and means the channel will speak in a monotone. Nonzero modulation values correspond to pitch and frequency deviations according to the following formula: Maximum pitch = BasePitch + PitchMod Minimum pitch = BasePitch - PitchMod Maximum Hertz = BaseHertz * 2(+ ModValue / 12) Minimum Hertz = BaseHertz * 2(- ModValue / 12) Given : BasePitch of 46.0 (≈115 Hertz), PitchMod of 2.0, Then: Maximum pitch = 48.0 (≈131 Hertz), Minimum pitch = 46.0 (≈104 Hertz) typedef Fixed *speechInfo; The API label for this selector is soPitchMod.volm Changes the current speaking volume on the specified channel. Volumes are expressed in fixed-point units ranging from 0.0 through 1.0 . A value of 0.0 corresponds to silence, and a value of 1.0 corresponds to the maximum possible volume. Volume units lie on a scale that is linear with amplitude or voltage. A doubling of perceived loudness corresponds to a doubling of the volume. The API label for this selector is soVolume. typedef Fixed *speechInfo;cvox Changes the current voice on the current speech channel to the specified voice. Note that this control call will return an incompatibleVoice error if the specified voice is incompatible with the speech synthesizer associated with the speech channel. The API label for this selector is soCurrentVoice. typedef VoiceSpec *speechInfo;dlim Sets the delimiter character strings for embedded commands. The start of an embedded command is determined by comparing the input characters to the start-command delimiter string. Likewise, the end of a command is determined by comparing the input characters to the end-command delimiter string. Command delimiter strings are either 1 or 2 bytes in length. If a single byte delimiter is desired, it should be followed by a null (0) byte. Delimiter characters must come from the set of printable characters. If the delimiter strings are empty, this will have the effect of disabling embedded command processing. Care must be taken not to choose delimiter strings that might occur naturally in the text to be spoken. The API label for this selector is soCommandDelimiter. typedef DelimiterInfo *speechInfo; typedef struct DelimiterInfo { Byte startDelimiter[2]; // defaults to "[[" Byte endDelimiter[2]; // defaults to "]]" } DelimiterInfo;rset Resets the speech channel to its default states. The speechInfo parameter should be set to 0. Specific synthesizers may provide other reset capabilities. The API label for this selector is soReset. typedef long *speechInfo;myA5 An application uses this selector to request that the speech synthesizer set up an A5 world prior to all callbacks. In order for an application to access any of its global data, it is necessary that register A5 contain the correct value, since all global variables are referenced relative to register A5. If you pass a non-null value in the speechInfo parameter, the speech synthesizer will set register A5 to this value just before it calls one of your callback routines. The A5 register is restored to its original value when your callback routine returns. The API label for this selector is soCurrentA5. typedef Ptr speechInfo; A typical application would make the call to SetSpeechInfo with code like the following: myA5 = SetCurrentA5(); err = SetSpeechInfo (mySpeechChannel, soCurrentA5, myA5);refc Sets the reference constant associated with the specified channel. All callbacks generated for this channel will return this reference constant for use by the application. The application can use this value any way it wants to. The API label for this selector is soRefCon. typedef long *speechInfo;tdcb Enables the callback that signals that text input processing is done. Your callback routine is invoked when the current buffer of input text has been processed and is no longer needed by the speech synthesizer. This callback does not indicate that the synthesizer is finished speaking the text (see the sdcb callback description, next), merely that the input text has been fully processed and is no longer needed by the speech synthesizer. This callback can be disabled by passing a null ProcPtr in the speechInfo parameter. When your callback routine is invoked, you have two options. If you set the nextBuf, byteLen, and controlFlags variables before returning, you will enable the speech synthesizer to continue speaking without any interruption in the output. If you set the nextBuf parameter to null, you are indicating that you have no more text to speak. The controlFlags parameter is defined as in SpeakBuffer. The API label for this selector is soTextDoneCallBack. typedef Ptr speechInfo; pascal void MyInputDoneCallback (SpeechChannel chan, long refCon, Ptr *nextBuf, long *byteLen, long *controlFlags);sdcb Enables an end-of-speech callback. Your callback routine is called whenever an input text stream has been completely processed and spoken. When your callback routine is invoked, you can be certain that the speech channel is now idle and no audio is being generated. This callback can be disabled by passing a null ProcPtr in the speechInfo parameter. The API label for this selector is soSpeechDoneCallBack. typedef Ptr speechInfo; pascal void MyEndOfSpeechCallback (SpeechChannel chan, long refCon);sycb Enables the sync command callback. Your callback routine is invoked when the text following a sync embedded command is about to be spoken. This callback can be disabled by passing a null ProcPtr in the speechInfo parameter. See “Embedded Speech Commands,” later in this document, for a description of how to use sync commands. The API label for this selector is soSyncCallBack. typedef Ptr speechInfo; pascal void MySyncCommandCallback (SpeechChannel chan, long refCon, OSType syncMessage);ercb Enables error callbacks. Your callback routine is called whenever an error occurs during the processing of an input text stream. Errors can result from syntax problems in the input text, insufficient CPU processing speed (such as an audio data underrun), or other conditions that may arise during the speech conversion process. If error callbacks have not been enabled, when an error condition is detected, the Speech Manager will save its value. The error codes can then be read using the GetSpeechInfo status selector soErrors (erro). The error callback can be disabled by passing a null ProcPtr in the speechInfo parameter. The API label for this selector is soErrorCallBack. typedef Ptr speechInfo; pascal void MyErrorCallback (SpeechChannel chan, long refCon, OSErr error, long bytePos);phcb Enables phoneme callbacks. Your callback routine is invoked for each phoneme generated by the speech synthesizer just before the phoneme is actually spoken. This callback can be disabled by passing a null ProcPtr in the speechInfo parameter. The API label for this selector is soPhonemeCallBack. typedef Ptr speechInfo; pascal void MyPhonemeCallBack (SpeechChannel chan, long refCon, short phonemeOpcode);wdcb Enables word callbacks. Your callback routine is invoked for each word generated by the speech synthesizer just before the word is actually spoken. This callback can be disabled by passing a nil ProcPtr in the speechInfo parameter. The API label for this selector is soWordCallBack. typedef Ptr speechInfo; pascal void MyWordCallback (SpeechChannel chan, long refCon, long wordPos, short wordLen);xtnd This call supports a general method for extending the functionality of the Speech Manager. It is used to set synthesizer-specific information. The speechInfo argument should be a pointer to the appropriate data structure. If a particular synthCreator value is not recognized by the synthesizer, the command is ignored and an siUnknownInfoType code is returned. The API label for this selector is soSynthExtension. typedef SpeechXtndData *speechInfo; typedef struct SpeechXtndData { OSType synthCreator; // synth creator ID Byte synthData[2]; // data TBD by synth } SpeechXtndData;RESULT CODESnoErr 0 No error paramErr –50 Parameter value is invalid siUnknownInfoType –231 Feature is not implemented on synthesizer incompatibleVoice –245 Specified voice cannot be used with synthesizer invalidComponentID –3000 Invalid SpeechChannel parameter Application-Defined Pronunciation DictionariesNo matter how sophisticated a speech synthesis system is, there will always be words that it does not automatically pronounce correctly. The clearest instance of words that are often mispronounced is the class of proper names (names of people, place names, and so on). One way to get around this fundamental limitation is to use a dictionary of pronunciations. Whenever a speech synthesizer needs to determine the proper phonemic representation for a particular word, it first looks for the word in its dictionaries. Pronunciation dictionary entries contain information that enables precise conversion between text and the correct phoneme codes. They also provide stress, intonation, and other information to help speech synthesizers produce more natural speech. If the word in question is found in the dictionary, then the synthesizer uses the information from the dictionary entry rather than relying on its own letter-to-sound rules. The use of phonemes is described in “Summary of Phonemes and Prosodic Controls,” later in this document.The Speech Manager word storage format provides high-quality data that is interchangeable between speech synthesizers. The Speech Manager also uses an easily extensible dictionary structure that does not affect the usability of existing dictionaries.It is assumed that application-defined pronunciation dictionaries will reside in RAM when in use. The run-time structure of dictionary data presumably depends on the specific needs of particular speech synthesizers and will therefore differ from the structure of the dictionaries as stored on disk.Associating a Dictionary With a Speech ChannelThe following routines can be used to associate an application-defined pronunciation dictionary with a particular speech channel.UseDictionaryThe UseDictionary routine associates a designated dictionary with a specific speech channel.pascal OSErr UseDictionary (SpeechChannel chan, Handle dictionary);Field descriptionschan Specific speech channeldictionary Handle to the specified dictionaryDESCRIPTIONThe speech synthesizer will attempt to use the dictionary data pointed to by the dictionary handle argument to augment the built-in pronunciation rules on the specified speech channel. The synthesizer will use whatever elements of the dictionary resource it considers useful to the speech conversion process. After returning from UseDictionary, the caller is free to release any storage allocated for the dictionary handle. The search order for application-provided dictionaries is last in, first searched.All details of how an application-provided dictionary is represented within the speech synthesizer are dependent on the specific synthesizer implementation and are totally private to the synthesizer.RESULT CODESnoErr 0 No error memFullErr –108 Not enough memory to use new dictionary badDictFormat –246 Format problem with pronunciation dictionary invalidComponentID –3000 Invalid SpeechChannel parameter Pronunciation Dictionary Data FormatEach application-defined pronunciation dictionary is implemented as a single resource of type 'dict'. To read the dictionary contents, the system first reads the resource into memory using Resource Manager routines.An application dictionary contains the following information:total byte length (long) (Length is all-inclusive) atom type (long) format version (long) script code (short) language code (short) region code (short) date last modified (long) (Seconds since January 1, 1904) reserved(4) (long) entry count (long) list of entries The currently defined atom type is'dict ' Æ Dictionary Each entry consists of the following:entry byte length (short) (Length is all-inclusive) entry type (short) field count (short) list of fields The currently defined entry types are the following:0x00 Æ Null entry 0x01 to 0x20 Æ Reserved 0x21 Æ Pronunciation entry 0x22 Æ Abbreviation entry Each field consists of the following:field byte length (short) (Length is all-inclusive minus padding) field type (short) field data (char[]) (Data is padded to word boundary) The currently defined field types are the following:0x00 Æ Null field 0x01 to 0x20 Æ Reserved 0x21 Æ Word represented in textual format. 0x22 Æ Phonemic pronunciation including a complete set of syllable, lexical stress, word prominence, and prosodic markers represented in textual format 0x23 Æ Part-of-speech code Creating and Editing DictionariesThere is no built-in support for creating and editing speech dictionaries. You can create dictionary resources using any of the available resource editing tools such as the MPW Rez tool or ResEdit. Of course, you can also fairly easily develop routines to edit the dictionary structure from within the application. At the present time, no assumption should be made that the entries in a dictionary are stored in sorted order.Advanced Voice Information RoutinesOrdinarily, an application should need to use only the GetVoiceDescription routine to access information about a particular voice. Occasionally, however, it may be necessary to obtain more detailed information by using the GetVoiceInfo routine.GetVoiceInfoThe GetVoiceInfo routine returns information about a specified voice channel beyond that obtainable through the GetVoiceDescription routine.pascal OSErr GetVoiceInfo (VoiceSpec *voice, OSType selector, void *voiceInfo); typedef VoiceDescription *voiceInfo; typedef VoiceFileInfo *voiceInfo; typedef struct VoiceFileInfo { FSSpec fileSpec; // vol, dir, name info for voice file short resID; // resource ID of voice in the file } VoiceFileInfo;enum { soVoiceDescription = 'info', // gets basic voice info soVoiceFile = 'fref' // gets voice file ref info };Field descriptions*voice Specific speech channelselector Used to specify data being requested*voiceInfo Pointer to an information structureDESCRIPTIONThis function accepts selectors that determine the type of information you want to get. The format of the information returned depends on which value is used in the selector field, as follows:Field descriptionsinfo Gets basic information for the specified voice. The structure returned is functionally equivalent to the VoiceDescription data structure in GetVoiceDescription, described earlier in this document. To maximize compatibility with future versions of the Speech Manager, the application must set the length field of the VoiceDescription structure to the size of the existing record before calling GetVoiceInfo, which then returns the size of the new record.fref Gets file reference information for specified voice; normally only used by speech synthesizers to access voice disk files directly.RESULT CODESnoErr 0 No error memFullErr –108 Not enough memory to load voice into memory voiceNotFound –244 Voice resource not found Embedded Speech CommandsThis section describes how you can insert commands directly into the input text to control or modify the spoken output. When processing input text data, speech synthesizers look for special sequences of characters called delimiters. These character sequences are usually defined to be unusual pairings of printable characters that would not normally appear in the text. When a begin command delimiter string is encountered in the text, the following characters are assumed to contain one or more commands. The synthesizer will attempt to parse and process these commands until an end command delimiter string is encountered.Embedded Speech Command SyntaxBy default, the begin command and end command delimiters are defined to be [[ and ]]. The syntax of embedded command blocks is given below, according to these rules: n Items enclosed in angle brackets (< and >) represent logical units that are either defined further below or are atomic units that should be self-explanatory. n Items enclosed in brackets are optional. n Items followed by an ellipsis (…) may be repeated one or more times. n For items separated by a vertical bar (|), any one of the listed items may be used. n Multiple space characters between tokens may be used if desired. n Multiple commands should be separated by semicolons.All other characters that are not enclosed between angle brackets must be entered literally. There is no limit to the number of commands that can be included in a single command block.Identifier Syntax CommandBlock <BeginDelimiter> <CommandList> <EndDelimiter> BeginDelimiter <String1> | <String2> EndDelimiter <String1> | <String2> CommandList <Command> [; <Command>]… Command <CommandSelector> [Parameter]… CommandSelector <OSType> Parameter <OSType> | <String1> | <String2> | <StringN> | <FixedPointValue> |<32BitValue> | <16BitValue> | <8BitValue> String1 <QuoteChar> <Character> <QuoteChar> String2 <QuoteChar> <Character> <Character> <QuoteChar> StringN <QuoteChar> [<Character>]… <QuoteChar> QuoteChar " | ' OSType <4 character pattern (e.g., RATE, vers, aBcD)> Character <Any printable character (example A, b, *, #, x)> FixedPointValue <Decimal number: 0.0000 £ N £ 65535.9999> 32BitValue <OSType> | <LongInt> | <HexLongInt> 16BitValue <Integer> | <HexInteger> 8BitValue <Byte> | <HexByte> LongInt <Decimal number: 0 £ N £ 4294967295> HexLongInt <Hex number: 0x00000000 £ N £ 0xFFFFFFFF> Integer <Decimal number: 0 £ N £ 65535> (continued) HexInteger <Hex number: 0x0000 £ N £ 0xFFFF> Byte <Decimal number: 0 £ N £ 255> HexByte <Hex number: 0x00 £ N £ 0xFF> Here is the embedded command syntax structure:Embedded Speech Command SetTable 1-1 outlines the set of currently defined embedded speech commands.Table 1-1 Embedded speech commands(continued)Command Selector Command syntax and description Version vers vers <Version>Version::= <32BitValue>This command informs the synthesizer of the format version that will be used in subsequent commands. This command is optional but is highly recommended. The current version is 1. Delimiter dlim dlim <BeginDelimiter> <EndDelimiter>The delimiter command specifies the character sequences that mark the beginning and end of all subsequent commands. The new delimiters take effect at the end of the current command block. If the delimiter strings are empty, an error is generated. (Contrast this behavior with the dlim function of SetSpeechInfo.) Comment cmnt cmnt [Character]…This command enables a developer to insert a comment into a text stream for documentation purposes. Note that all characters following the cmnt selector up to the <EndDelimiter> are part of the comment. Reset rset rset <32BitValue>The reset command will reset the speech channel’s settings back to the default values. The parameter should be set to 0. (continued) Baseline pitch pbas pbas [+ | -] <Pitch>Pitch ::= <FixedPointValue>The baseline pitch command changes the current pitch for the speech channel. The pitch value is a fixed-point number in the range 1.0 through 100.0 that conforms to the frequency relationship Hertz = 440.0 * 2((Pitch – 69) / 12)If the pitch number is preceded by a + or – character, the baseline pitch is adjusted relative to its current value. Pitch values are always positive numbers. For further details, see “SetSpeechInfo,” earlier in this document. Pitch modulation pmod pmod [+ | -] <ModulationDepth>ModulationDepth ::= <FixedPointValue>The pitch modulation command changes the modulation range for the speech channel. The modulation value is a fixed-point number in the range 0.0 through 100.0 that conforms to the following pitch and frequency relationships:Maximum pitch = BasePitch + PitchModMinimum pitch = BasePitch - PitchModMaximum Hertz = BaseHertz * 2(+ ModValue / 12)Minimum Hertz = BaseHertz * 2(– ModValue / 12)A value of 0.0 corresponds to no modulation and will cause the speech channel to speak in a monotone. If the modulation depth number is preceded by a + or – character, the pitch modulation is adjusted relative to its current value. For further details, see “SetSpeechInfo,” earlier in this document. Speaking rate rate rate [+ | -] <WordsPerMinute>WordsPerMinute ::= <FixedPointValue>The speaking rate command sets the speaking rate in words per minute on the speech channel. If the rate value is preceded by a + or – character, the speaking rate is adjusted relative to its current value. (continued) Volume volm volm [+ | -] <Volume>Volume::= <FixedPointValue>The volume command changes the speaking volume on the speech channel. Volumes are expressed in fixed-point units ranging from 0.0 through 1.0 . A value of 0.0 corresponds to silence, and a value of 1.0 corresponds to the maximum possible volume. Volume units lie on a scale that is linear with amplitude or voltage. A doubling of perceived loudness corresponds to a doubling of the volume. Sync sync sync <SyncMessage>SyncMessage::= <32BitValue>The sync command causes a callback to the application’s sync command callback routine. The callback is made when the audio corresponding to the next word begins to sound. The callback routine is passed the SyncMessage value from the command. If the callback routine has not been defined, the command is ignored. For further details, see “SetSpeechInfo,” earlier in this document. Input mode inpt inpt TX | TEXT | PH | PHONThis command switches the input processing mode to either normal text mode or raw phoneme mode. Character mode char char NORM | LTRLThe character mode command sets the word speaking mode of the speech synthesizer. When NORM mode is selected, the synthesizer attempts to automatically convert words into speech. This is the most basic function of the text-to-speech synthesizer. When LTRL mode is selected, the synthesizer speaks every word, number, and symbol letter by letter. Embedded command processing continues to function normally, however. Number mode nmbr nmbr NORM | LTRLThe number mode command sets the number speaking mode of the speech synthesizer. When NORM mode is selected, the synthesizer attempts to automatically speak numeric strings as intelligently as possible. When LTRL mode is selected, numeric strings are spoken digit by digit. (continued) Silence slnc slnc <Milliseconds>Milliseconds ::= <32BitValue>The silence command causes the synthesizer to generate silence for the specified amount of time. Emphasis emph emph + | -The emphasis command causes the next word to be spoken with either greater emphasis or less emphasis than would normally be used. Using + will force added emphasis, while using – will force reduced emphasis. Synthesizer-Specific xtnd xtnd <SynthCreator> [parameter]SynthCreator ::= <OSType>The extension command enables synthesizer-specific commands to be embedded in the input text stream. The format of the data following SynthCreator is entirely dependent on the synthesizer being used. If a particular SynthCreator is not recognized by the synthesizer, the command is ignored but no error is generated. Synthesizers often support embedded commands that extend the set given in Table 1-1. Embedded Speech Command Error ReportingWhile embedded speech commands are being processed, several types of errors may be detected and reported to your application. If you have set up an error callback handler with the soErrorCallBack selector of the SetSpeechInfo routine (described earlier), you will be notified once for every error that is detected. If you have not enabled error callbacks, you can still obtain information about the errors encountered by calling GetSpeechInfo with the soErrors selector (also described earlier). The following errors are detected during processing of embedded speech commands:badParmVal –245 Parameter value is invalid badCmdText –246 Embedded command syntax or parameter problem unimplCmd –247 Embedded command is not implemented on synthesizer unimplMsg –248 Raw phoneme text contains invalid characters badVoiceID –250 Specified voice has not been preloaded badParmCount –252 Incorrect number of embedded command arguments found Summary of Phonemes and Prosodic ControlsThis section summarizes the phonemes and prosodic controls used by American English speech synthesizers.Phoneme SetTable 1-2 summarizes the set of standard phonemes recognized by American English speech synthesizers.In this description, it is assumed that specific rules and markers apply only to general American English. Other languages and dialects require different phoneme inventories. Phonemes divide into two groups: vowels and consonants. All vowel symbols are uppercase pairs of letters. For consonants, in cases in which the correspondence between the consonant and its symbol is apparent, the symbol is that lowerrcase consonant; in other cases, the symbol is an uppercase consonant. Within the example words, the individual sounds being exemplified appear in bold face.Table 1-2 American English phoneme symbols(continued)Symbol Example Opcode Symbol Example Opcode AE bat 2 b bin 18 EY bait 3 C chin 19 AO caught 4 d din 20 AX about 5 D them 21 IY beet 6 f fin 22 EH bet 7 g gain 23 IH bit 8 h hat 24 AY bite 9 J gin 25 IX roses 10 k kin 26 AA cot 11 l limb 27 UW boot 12 m mat 28 UH book 13 n nat 29 UX bud 14 N tang 30 OW boat 15 p pin 31 AW bout 16 r ran 32 OY boy 17 s sin 33 S shin 34 t tin 35 T thin 36 v van 37 w wet 38 (continued) y yet 39 % silence 0 z zen 40 @ breath intake 1 Z genre 41 NoteThe “silence” phoneme (%) and the “breath” phoneme (@) may be lengthened or shortened like any other phoneme.uProsodic ControlsThe symbols listed in Table 1-3 are recognized as modifiers to the basic phonemes described in the preceding section. They can be used to more precisely control the quality of speech that is described in terms of raw phonemes.Table 1-3 Prosodic control symbols(continued)Type Symbol Description of effect Lexical stress: Marks stress within a word Primary stress 1 anticipation AEnt2IHsIXp1EYSAXn (“anticipation”) Secondary stress 2 anticipation Syllable breaks: Marks syllable breaks within a word Syllable mark = (equal) AEn=t2IH=sIX=p1EY=SAXn (“anticipation”)Marks the beginning of a word (required) Word prominence: Unstressed ~ (asciitilde) Used for words with minimal information content Normal stress _ (underscore) Used for information-bearing words Emphatic stress + (plus) special emphasis for a wordPlaced before the affected phonemepitch will rise on the following phoneme Prosodic Pitch rise / (slash) Pitch fall \ (backslash) pitch will fall on the following phoneme Lengthen phoneme > (greater) lengthen the duration of the following phoneme Shorten phoneme < (less) shorten the duration of the following phoneme (continued) Punctuation: Pitch effect Timing effect . (period) Sentence final fall Pause follows ? (question) Sentence final rise Pause follows ! (exclam) Sentence final sharp fall Pause follows … (ellipsis) Clause final level Pause follows , (comma) Continuation rise Short pause follows ; (semicolon) Continuation rise Short pause follows : (colon) Clause final level Short pause follows ( (parenleft) Start reduced range Short pause precedes ) (parenright) End reduced range Short pause follows “‘ (quotedblleft, quotesingleleft) Varies Varies ”’ (quotedblright, quotesingleright) Varies Varies - (hyphen) Clause-final level Short pause follows & (ampersand) Forces no addition of silence between phonemes Specific pitch contours associated with these punctuation marks may vary according to other considerations in the analysis of the text, such as whether a question is rhetorical or begins with a wh question word, so the above effects should be regarded only as guidelines and not absolute. This also applies to the timing effects, which will vary according to the current rate setting.The prosodic control symbols (/, \, <, and >) may be concatenated to provide more exaggerated, cumulative effects. The specific nature of the effect is dependent on the speech synthesizer. Speech synthesizers also often extend or enhance the controls described in this section. Summary of the Speech ManagerConstants#define gestaltSpeechAttr 'ttsc' // Gestalt Manager selector for speech attributes enum { gestaltSpeechMgrPresent = 0 // Gestalt bit that indicates that Speech Manager exists };#define kTextToSpeechSynthType 'ttsc' // text-to-speech synthesizer component type #define kTextToSpeechVoiceType 'ttvd' // text-to-speech voice resource type #define kTextToSpeechVoiceFileType 'ttvf' // text-to-speech voice file type #define kTextToSpeechVoiceBundleType 'ttvb' // text-to-speech voice bundle file type enum { // Speech Manager error codes (range from 240 - 259) noSynthFound = -240, synthOpenFailed = -241, synthNotReady = -242, bufTooSmall = -243, voiceNotFound = -244, incompatibleVoice = -245, badDictFormat = -246, badPhonemeText = -247};enum { // constants for SpeakBuffer and text done callback controlFlags bits kNoEndingProsody = 1, kNoSpeechInterrupt = 2, kPreflightThenPause = 4};enum { // constants for StopSpeechAt and PauseSpeechAt kImmediate = 0, kEndOfWord = 1, kEndOfSentence = 2};// GetSpeechInfo & SetSpeechInfo selectors #define soStatus 'stat'#define soErrors 'erro'#define soInputMode 'inpt'#define soCharacterMode 'char'#define soNumberMode 'nmbr'#define soRate 'rate'#define soPitchBase 'pbas'#define soPitchMod 'pmod'#define soVolume 'volm'#define soSynthType 'vers'#define soRecentSync 'sync'#define soPhonemeSymbols 'phsy'#define soCurrentVoice 'cvox'#define soCommandDelimiter 'dlim'#define soReset 'rset'#define soCurrentA5 'myA5'#define soRefCon 'refc'#define soTextDoneCallBack 'tdcb'#define soSpeechDoneCallBack 'sdcb'#define soSyncCallBack 'sycb'#define soErrorCallBack 'ercb'#define soPhonemeCallBack 'phcb'#define soWordCallBack 'wdcb'#define soSynthExtension 'xtnd'// speaking mode constants #define modeText 'TEXT' // input mode constants #define modeTX 'TX'#define modePhonemes 'PHON'#define modePH 'PH'#define modeNormal 'NORM' // character mode and number mode constants #define modeLiteral 'LTRL'enum { // GetVoiceInfo selectors soVoiceDescription = 'info', // gets basic voice info soVoiceFile = 'fref' // gets voice file ref info };enum {kNeuter = 0, kMale, kFemale}; // returned in gender field below Data Typestypedef struct SpeechChannelRecord { long data[1];} SpeechChannelRecord;typedef SpeechChannelRecord *SpeechChannel;typedef struct VoiceSpec { OSType creator; // creator ID of required synthesizer OSType id; // voice ID on the specified synth } VoiceSpec;typedef struct VoiceDescription { long length; // size of structure - set by application VoiceSpec voice; // voice creator and ID info long version; // version code for voice Str63 name; // name of voice Str255 comment; // additional text info about voice short gender; // neuter, male, or female short age; // approximate age in years short script; // script code of text voice can process short language; // language code of voice output short region; // region code of voice output long reserved[4]; // reserved for future use } VoiceDescription;typedef struct VoiceFileInfo { FSSpec fileSpec; // volume, dir, & name information for voice file short resID; // resource ID of voice in the file } VoiceFileInfo;typedef struct SpeechStatusInfo { Boolean outputBusy; // true if audio is playing Boolean outputPaused; // true if channel is paused long inputBytesLeft; // bytes left to process short phonemeCode; // opcode for cur phoneme } SpeechStatusInfo;typedef struct SpeechErrorInfo { short count; // # of errs since last check OSErr oldest; // oldest unread error long oldPos; // char position of oldest err OSErr newest; // most recent error long newPos; // char position of newest err } SpeechErrorInfo;typedef struct SpeechVersionInfo { OSType synthType; // always 'ttsc' OSType synthSubType; // synth flavor OSType synthManufacturer; // synth creator ID long synthFlags; // synth feature flags NumVersion synthVersion; // synth version number } SpeechVersionInfo;typedef struct PhonemeInfo { short opcode; // opcode for the phoneme Str15 phStr; // corresponding char string Str31 exampleStr; // word that shows use of phoneme short hiliteStart; // segment of example word that short hiliteEnd; // hilighted text (ala TextEdit) } PhonemeInfo;typedef struct PhonemeDescriptor { short phonemeCount; // # of elements PhonemeInfo thePhonemes[1]; // element list } PhonemeDescriptor;typedef struct SpeechXtndData { OSType synthCreator; // synth creator ID Byte synthData[2]; // data TBD by synth } SpeechXtndData;typedef struct DelimiterInfo { Byte startDelimiter[2]; // defaults to [[ Byte endDelimiter[2]; // defaults to ]] } DelimiterInfo;Voice Routinespascal OSErr MakeVoiceSpec (OSType creator, OSType id, VoiceSpec *voice);pascal OSErr CountVoices (short *numVoices);pascal OSErr GetIndVoice (short index, VoiceSpec *voice);pascal OSErr GetVoiceDescription (VoiceSpec *voice, VoiceDescription *info, long infoLength);pascal OSErr GetVoiceInfo (VoiceSpec *voice, OSType selector, void *voiceInfo);Routines for Managing Speech Channelspascal OSErr NewSpeechChannel (VoiceSpec *voice, SpeechChannel *chan);pascal OSErr DisposeSpeechChannel (SpeechChannel chan);Speaking Routinespascal OSErr SpeakString (StringPtr s);pascal OSErr SpeakText (SpeechChannel chan, Ptr textBuf, long textBytes);pascal OSErr StopSpeech (SpeechChannel chan);pascal OSErr StopSpeechAt (SpeechChannel chan, long whereToStop);pascal OSErr PauseSpeechAt (SpeechChannel chan, long whereToPause);pascal OSErr ContinueSpeech (SpeechChannel chan);pascal OSErr SpeakBuffer (SpeechChannel chan, Ptr textBuf, long textBytes, long controlFlags);Information and Control Routinespascal NumVersion SpeechManagerVersion (void);pascal short SpeechBusy (void);pascal OSErr SetSpeechRate (SpeechChannel chan, Fixed rate);pascal OSErr GetSpeechRate (SpeechChannel chan, Fixed *rate);pascal OSErr SetSpeechPitch (SpeechChannel chan, Fixed pitch);pascal OSErr GetSpeechPitch (SpeechChannel chan, Fixed *pitch);pascal short SpeechBusySystemWide (void);pascal OSErr SetSpeechInfo (SpeechChannel chan, OSType selector, void *speechInfo);pascal OSErr GetSpeechInfo (SpeechChannel chan, OSType selector, void *speechInfo);Text-to-Phoneme Conversion Routinepascal OSErr TextToPhonemes (SpeechChannel chan, Ptr textBuf, long textBytes, Handle phonemeBuf, long *phonemeBytes) Dictionary Management Routinepascal OSErr UseDictionary (SpeechChannel chan, Handle dictionary)Callback Prototypes // text-done callback routine typedef typedef pascal void (*TextDoneProcPtr) (SpeechChannel, long, Ptr *, long *, long *); // speech-done callback routine typedef typedef pascal void (*SpeechDoneProcPtr) (SpeechChannel, long ); // sync callback routine typedef typedef pascal void (*SyncProcPtr) (SpeechChannel, long, OSType); // error callback routine typedef typedef pascal void (*ErrorProcPtr) (SpeechChannel, long, OSErr, long); // phoneme callback routine typedef typedef pascal void (*PhonemeProcPtr) (SpeechChannel, long, short); // word callback routine typedef typedef pascal void (*WordProcPtr) (SpeechChannel, long, long, short);Error Return CodesnoErr 0 No error paramErr –50 Parameter error memFullErr –108 Not enough memory to speak nilHandleErr –109 Handle argument is nil siUnknownInfoType –231 Feature not implemented on synthesizer noSynthFound –240 Could not find the specified speech synthesizer synthOpenFailed –241 Could not open another speech synthesizer channel synthNotReady –242 Speech synthesizer is still busy speaking bufTooSmall –243 Output buffer is too small to hold result voiceNotFound –244 Voice resource not found incompatibleVoice –245 Specified voice cannot be used with synthesizer badDictFormat –246 Format problem with pronunciation dictionary badPhonemeText –247 Raw phoneme text contains invalid characters invalidComponentID –3000 Invalid SpeechChannel parameter ö ◊# ˇ ˇˇˇˇ # ◊
• )36 ° d ONLN d· ø8 ( øAssociating a Dictionary W @ ° d ONLN d˚ 8ó )yith a Speech Channel g@ ° d ONLN d óô )_ Á@ ° d ONLN d ôõ ) g@ ° d ONLN d ú¶ )37 ° d ONLN d ø$ » (! øPr N† ° d ONLN d …$l )
#onunciation Dictionary Data Format N¿ ° d ONLN d:l$n )£ Œ¿ ° d ONLN d;n$p ) N¿ ° d ONLN d<q${ )38 ° d ONLN d?% ø1 (. øCr \ ° d ONLN dA% 1V ) eating and Editing Dictionaries ≤@ ° d ONLN da%V1X )å 2@ ° d ONLN db%Y1[ ) ≤@ ° d ONLN dc%[1e )39 ° d ONLN df2 ø> ˆ (; ø
° d ONLN d ; ] G › ( D ] This document describes the Ã` ° d ONLN d ; › G ¯ )ÄApple I‡ ° d ONLN d ! 9 ˘ B ˛ ( @ ˘®
C‡ ° d ONLN d " ; ˇ GJ + Speech Manager /@ ° d ONLN d 1 ;J Gv )K
, which pr »¿ ° d ONLN d ; ;v Gæ ),ovides a standar ¿ ° d ONLN d K ;ø G⁄ )Idized ° d ONLN d Q H ] T ø ( Q ]method for Macintosh ‰ ° d ONLN d e F ø O ƒ ( M ø®
s— )≠-om text. The necessary information and calls ° d ONLN d3 t ] Ä ( } ],needed by all text-to-speech applications ar ¿ ° d ONLN d_ t Ä› )ø+e given next, followed by a simple example ° d ONLN dä Å ] ç – ( ä ]of speech generation. Mor e ° d ONLN d£ Å – çz )s&e advanced calls and special-purpose r fl† ° d ONLN d… Åz ç• )™
outines ar § ° d ONLN d” Ŷ ç⁄ ), e described ° d ONLN dfl é ] ö n ( ó ]last.
° d ONLN dˇ › ] È d ( Ê ]A ∫† ° d ONLN d › d ȧ )H complete system for speech synthesis consists of the elements shown in ⁄Ä ° d ONLN dH ›§ Ⱥ ( ʧFigur ≠@ ° d ONLN dM ›º È– )e 1-1 J¿ ° d ONLN dR ›— È” ).
È 4 È " ]
ˇ·ˇ‚ˆA ° d ONLN dT ] á ( ]
Figure 1-1 ° d ONLN d_ ü )BSpeech synthesis components
° d ONLN d|r ]~ ª ({ ]An application calls r íÄ ° d ONLN dír ª~” )^@outines in the Speech Manager to convert character strings into ° d ONLN d“ ]ã- (à ]/speech and to adjust various parameters that af 7@ ° d ONLN d.ãÁ )—,fect the quality or character of the spoken ° d ONLN d-å ]ò Ï (ï ] output. The Speech Manager is r ŸÄ ° d ONLN dLå ÏòÄ )è"esponsible for dispatching these r ˝@ ° d ONLN dnåÄò÷ )îequests to a speech ° d ONLN dÇô ]• è (¢ ] synthesizer ° d ONLN dçô è•ñ )2<. The speech synthesizer converts the text into sound and cr ÛÄ ° d ONLN d…ôï•€ (¢ïeates the actual ° d ONLN d⁄¶ ]≤ ú (Ø ]audio output. ° d ONLN dÈ∏ ]ƒ p *The ]` ° d ONLN dÌ∏ pƒ ‚ )Apple-supplied voices, pr Ô` ° d ONLN d∏ ‚ƒ– )r5onunciation dictionaries, and speech synthesizer may ° d ONLN d;≈ ]— ` (Œ ]r E ° d ONLN d<≈ a— Ø )eside in a single fi ¿ ° d ONLN dP≈ ∞— ˛ )Ole or in separate fi ˇ¿ ° d ONLN dd≈ ˛—1 )N les. These fi =‡ ° d ONLN dq≈2—I )4les ar q‡ ° d ONLN dw≈I—ê )e clearly identifi ûÄ ° d ONLN dâ≈ê—“ )Gable as Speech ° d ONLN dò“ ]fi ç (€ ] Manager–r ◊ ° d ONLN d°“ çfi ∞ )0elated fi =Ä ° d ONLN d™“ ±fi € )$
les and ar fi† ° d ONLN d¥“ €fi" )*e installed and r …† ° d ONLN d≈“"fi )G+emoved by being dragged into or out of the ° d ONLN dfl ]Î ú (Ë ]System Folder ÛÄ ° d ONLN d˝fl õÎ † )>. ï ° d ONLN dˇfl †Î )Additional voices can be pr ´@ ° d ONLN dflÎá )yovided by bundling the r ¿ ° d ONLN d2flàΆ )oesour _ ° d ONLN d7fl†ÎÀ ) ces in the ° d ONLN dBÏ ]¯ ` (ı ]r E ° d ONLN dCÏ a¯ y )esour ç@ ° d ONLN dHÏ y¯ ≈ )ce forks of specifi ¿ ° d ONLN d[Ï Δ¯( )Mc applications. These r Ú@ ° d ONLN drÏ'¯? )aesour :Ä ° d ONLN dwÏ@¯X )ces ar ˆ` ° d ONLN d}ÏX¯Ñ )
¿ ° d ONLN d≠2 r>. )-ely by the application. The application is fr ß¿ ° d ONLN d⁄2.>V )º
ee to stor ¨¿ ° d ONLN d‰2V>À )( e dictionaries in either the ° d ONLN d? ]K ` (H ]r E ° d ONLN d? aK y )esour ç@ ° d ONLN d? yK ‰ )ce or the data fork of a fi ° d ONLN d"? ÂKF )lle. The application is r õ ° d ONLN d:?FKª )aesponsible for loading the ° d ONLN dUL ]X (U ]Yindividual dictionaries into RAM and then passing a handle to the dictionary data to the ° d ONLN dÆY ]e ¶ *Speech Manager Î` ° d ONLN dºY •e ß )H. ° d ONLN dæk ]w< (t ]0Applications that use the Speech Manager must pr Δ¿ ° d ONLN dÓk<wfi )fl$ovide their own human interface for ° d ONLN dx ]Ñ › (Å ] selecting voices and/or contr R ° d ONLN d/x fiÑ® )Å1olling other speech characteristics. If voices ar M† ° d ONLN d`x®Ñπ ) e pr ^` ° d ONLN ddxπÑ )
ovided in ° d ONLN dnÖ ]ë ä (é ]
separate fi ° d ONLN dyÖ ãë> ).*les, the speech synthesizer developer is r ,‡ ° d ONLN d£Ö>ëà )≥esponsible for pr ^† ° d ONLN d¥ÖàëË )Joviding a method for ° d ONLN d…í ]û ¶ (õ ]installing these r {¿ ° d ONLN d€í ¶û æ )Iesour ƒ ° d ONLN d‡í æûå )/ces into the System Folder or Extensions folder ∫@ ° d ONLN d íåû— )Œ. The computer
° d ONLN d ; { G § ( D { must be r ¿ ° d ONLN d ; § GC ))$ebooted after speech synthesizers ar ¿ ° d ONLN d - ;D GÑ )†e added to or r Â@ ° d ONLN d < ;Ñ G± )@ emoved fr ‡ ° d ONLN d E ;≤ Gı ).om the System ° d ONLN d S H { T œ ( Q {Folder for the desir . ° d ONLN d g H – T )Ued changes to be r ä` ° d ONLN d y H TN )O
° d ONLN d û ó { £ ( † {&On a simple level, speech synthesis fr o ° d ONLN d ƒ ó £ß )• om text input is a two-stage pr \` ° d ONLN d „ óß £‹ )áocess. First, ° d ONLN d Ò § { ∞C ( ≠ {.plain-language English text is converted into À† ° d ONLN d §C ∞p )»phonemic U¿ ° d ONLN d' §q ∞w ). r ö¿ ° d ONLN d) §w ∞Ö )epr +Ä ° d ONLN d, §Ü ∞Ÿ )esentations for the ° d ONLN d@ ± { Ω Ω ( ∫ {individual wor È@ ° d ONLN dN ± Ω ΩC )B ds. Phonemes stand for specifi ¿ ° d ONLN dl ±D Ω˙ )á*c sounds; for a complete explanation, see ° d ONLN dñ æ { ( « {“Summary of Phonemes and Pr ;‡ ° d ONLN d± æ ? )å osodic Contr ΩÄ ° d ONLN dΩ æ? S )8ols,” ÿ` ° d ONLN d¬ æS “ ) later in this document. The r m ° d ONLN d‡ æ” ˘ )Ä esulting ° d ONLN dÈ À { ◊¯ ( ‘ {Ssequence of phonemes is converted into audible sounds by mapping of the individual ° d ONLN d< ÿ { ‰B *+phonemes to a series of waveforms, which ar S` ° d ONLN dg ÿB ‰¶ )«e sent to the sound har â¿ ° d ONLN d~ ÿ¶ ‰Ω )ddwar ¡Ä ° d ONLN dÇ ÿΩ ‰˝ )e to be played. ° d ONLN dí Í { ˆ ä ( Û {In r Ù‡ ° d ONLN dñ Í ä ˆ ¢ )eality E ° d ONLN dú Í ¢ ˆ Ú ), each stage is mor ‹@ ° d ONLN dØ Í Ú ˆˆ )P;e complicated than this description suggests. For example, ° d ONLN dÍ ˜ {£ ( {Aduring the text-to-phoneme conversion stage, number strings, abbr ÆÄ ° d ONLN d+ ˜£ ( £eviations, and special ° d ONLN dB {[ ( {0symbols must be detected and converted into appr a ° d ONLN dr[é )‡ opriate wor —@ ° d ONLN d}é± )3ds befor ↠° d ONLN dÖ≤ )$e being converted ° d ONLN dó { ( {Vinto phonemes. When a sentence such as “He earned over $2,000,000 in 1990” is spoken, ° d ONLN dÌ {* ‰ *it would normally be pr @ ° d ONLN d Â* )jAeferable to say “He earned over two million dollars in nineteen- ° d ONLN dE+ {78 (4 {*ninety” rather than “He earned over dollar € ° d ONLN do+87ú )Ω-sign, two, comma, zer ‡ ° d ONLN dÖ+ú7¥ )do, zer ‰ ° d ONLN dã+¥7à )o, zer Ë@ ° d ONLN dë+Ã7¸ )
o, comma, ° d ONLN dõ8 {D à (A {zer † ° d ONLN dû8 âD ° )o, zer ¿ ° d ONLN d§8 °D π )o, zer ‡ ° d ONLN d™8 πD" )o, in one, nine, nine, zer ¿ ° d ONLN dƒ8"D7 )io.” T ∫ ° d ONLN d…86DG )o pr v† ° d ONLN dÕ8HDã )oduce the desir ˆ ° d ONLN d‹8ãD€ )Ced spoken output ° d ONLN dÌE {Q ∑ (N {automatically Ú ° d ONLN d˙E ∂QQ );$, knowledge of these sorts of constr v ° d ONLN d ERQÏ )ú%uctions is built into the synthesizer —` ° d ONLN dCEÎQÌ )ô. ° d ONLN dEW {cÙ (` {PThe phoneme-to-sound conversion stage is also complex. Phonemes by themselves ar Á† ° d ONLN dïWÙc˚ (`Ùe ° d ONLN dód {p ≤ (m {often not suf ` ° d ONLN d§d ≥p π )8fi ' ° d ONLN d¶d πpB ) cient to describe the way a wor (‡ ° d ONLN d≈dBpÇ )âd should be pr l ° d ONLN d”dÇpˇ )@onounced. For example, the ° d ONLN dÓq {} å (z {wor Ä ° d ONLN dÒq ç} œ )d “object” is pr i‡ ° d ONLN dq œ} )B onounced dif ˛¿ ° d ONLN dq } ):fer ·@ ° d ONLN dq}ˇ ) 5ently depending on whether it is used as a noun or a ° d ONLN dE~ {ä) (á {)verb. (When it is used as a noun, the str ¢ ° d ONLN dn~)äÜ )Æess is placed on the fi ¸@ ° d ONLN dÖ~Üä∫ )]rst syllable. f` ° d ONLN dì~ªä˙ )5As a verb, the ° d ONLN d¢ã {ó Ü (î {str ƒ` ° d ONLN d•ã Üós ) 9ess is placed on the second syllable.) In addition to str ”@ ° d ONLN dfiãsó )Ì ess information, phonemes must ° d ONLN d˝ò {§≠ (° {Doften be augmented with pitch, duration, and other information to pr Z¿ ° d ONLN dAò≠§˛ (°≠oduce intelligible, ° d ONLN dU• {± Î (Æ {natural-sounding speech. ° d ONLN dn∑ {√8 **The speech synthesizer has many built-in r }@ ° d ONLN dò∑8√ )Ω0ules for automatically converting text into the ° d ONLN d»ƒ {– ’ (Õ {complex phonemic r Ï ° d ONLN d⁄ƒ ’– „ )Zepr |‡ ° d ONLN d›ƒ ‰–â )#esentation described above. However ¶¿ ° d ONLN d ƒâ–ü )•, ther I ° d ONLN dƒ†–È )e will always be ° d ONLN d— {› å (⁄ {wor Ä ° d ONLN d— ç› Ó )ds and phrases that ar |@ ° d ONLN d0— Ó› )ae not pr ñ@ ° d ONLN d8—›Ú )".onounced the way you want. The Speech Manager ° d ONLN dffi {Í √ (Á {allows you to pr e ° d ONLN dvfi √Íd )H"ovide raw phonemic information dir -@ ° d ONLN dòfieÍë )¢ ectly in or @ ° d ONLN d£fiëÍÌ ),der to enable very pr 2Ä ° d ONLN d∏fiÌÍ )\ecise ° d ONLN dæÎ {˜ ë (Ù {contr >Ä ° d ONLN d√Î í˜ )ol over the spoken output. ° d ONLN dfi˝ { ÿ ( {MBy default, speech synthesizers expect input in normal language text. However Ä ° d ONLN d +˝ÿ ¯ (ÿ, using ° d ONLN d 3
{ ÿ ( {the input mode contr – ° d ONLN d G
ÿK )]ols of the Speech Manager ˝ ° d ONLN d `
K‡ )s$, you can tell the synthesizer to pr ‡ ° d ONLN d Ñ
‡˘ )ïocess ° d ONLN d ä {#˜ ( {Qinput text in raw phonemic form. By using the embedded commands described in the ° d ONLN d €$ {0 *Wnext section, you can even mix normal language text with phonemic text within a single ° d ONLN d
21 {= ƒ *string or text buf O ° d ONLN d
D1 ≈= — )Jfer °¿ ° d ONLN d
G1 –= “ ) . ° d ONLN d
IC {O å (L {See ” ° d ONLN d
MC åO )“Summary of Phonemes and Pr é‡ ° d ONLN d
hCOP )å osodic Contr Ä ° d ONLN d
tCQOe )9ols,” +` ° d ONLN d
yCeO )' later in this document, for a listing ° d ONLN d
†P {\Q (Y {0of the phonemic character set and each character ¸` ° d ONLN d
° d ONLN d x ] Ñ ” ( Å ] This section describes the r @ ° d ONLN d 6 x ‘ Ñì )w+outines used to add speech synthesis featur ”¿ ° d ONLN d a xì Ñ∑ )ø es to an ° d ONLN d j Ö ] ë Ø ( é ]application. It is or 7† ° d ONLN d Ö ∞ ë ˆ )Sganized into thr ∞@ ° d ONLN d è Ö ˆ ë* )Fee sections: È ° d ONLN d ú Ö* ëw )4“Getting Started” =‡ ° d ONLN d ≠ Öx ëõ )N (Easy), MÄ ° d ONLN d ∂ Öõ ë… )# “Essential ° d ONLN d ¡ í ] û ” ( õ ]Calls—Simple and Useful” S` ° d ONLN d Ÿ í ‘ û. )w (Intermediate), and ƒÄ ° d ONLN d Ó í. ûë )Z“Advanced Routines.”
√ È 4 ƒ È ≈ ] ≈È
ˇ·ˇ‚ˆA ˇˇ‹. ˇ◊ ° d ONLN d ¥ ] √ π ( ø ]Getting Started ˇˇˇˇˇˇ €r ( ø·1
° d ONLN d ] ÷ } ( ” ]If you’r J` ° d ONLN d ~ ÷Ÿ )!Ne just getting started with text-to-speech conversion using the Speech Manager ¿ ° d ONLN dj ÿ ÷› ( ”ÿ, ° d ONLN dl ◊ ] „ û ( ‡ ]the following r —‡ ° d ONLN d{ ◊ û „ )A outines will get you up and r ›@ ° d ONLN dò ◊ „á )Äunning with minimal ef ≈Ä ° d ONLN dÆ ◊á „º )ifort. If you’r é@ ° d ONLN dº ◊Ω „ƒ )6e ° d ONLN dæ ‰ ] ó ( Ì ]Fdeveloping an application that does not need to choose voices, use mor Ä` ° d ONLN d ‰ó « ( Ìó e than one ° d ONLN d Ò ] ˝ œ ( ˙ ]channel of speech, or exer \¿ ° d ONLN d) Ò œ ˝  )rcise r ° d ONLN d/ Ò Ê ˝# )eal-time contr ¿ ° d ONLN d= Ò# ˝› )=*ol over the synthesized speech, these may ° d ONLN dg ˛ ]
î ( ]be the only r ≤ ° d ONLN dt ˛ î
‚ )7outines you need.
( /È 4) /È * ]*È
ˇ·ˇ‚ˆA ° d ONLN dÜ ])* (% ]%Determining If the Speech Manager Is 7 ° d ONLN d´*)2 )ÕA @ ° d ONLN d¨2)Z )vailable ˇˇˇˇˇˇ ‘@ )∞1
° d ONLN d∂/ ]; c (8 ]Y @Ä ° d ONLN d∑/ c; à )ou can fi Ä ° d ONLN d¿/ â;À )&Lnd out if the Speech Manager is available with a single call to the Gestalt ° d ONLN d < ]H Ñ (E ]Manager T† ° d ONLN d< ÑH â )'. . ° d ONLN dN ]Z Ç (W ]Use the ,
Courier ° d ONLN d N ÇZ ¨ )%Gestalt ° d ONLN d%N ¨Z ’ )*
toolbox r R` ° d ONLN d/N ’Z= ))outine and the selector R` ° d ONLN dGN=Z£ )hgestaltSpeechAttr R` ° d ONLN dXN£Z‡ )f to determine ° d ONLN df[ ]gt (d ]<whether or not the Speech Manager is available, as shown in ° d ONLN d¢[tg§ (dt Listing 1-1 ° d ONLN d≠[§g≥ )0. If ° d ONLN d≤[≥g› )Gestalt ° d ONLN dπ[›gfl )* ˇˇ¶T ° d ONLN d∫h ]t a (q ]r R` ° d ONLN dªh at } )eturns ˇ˛Ú¸ ¯¥ ° d ONLN d¬h }t õ ) noErr ˇˇ¶T ;T ° d ONLN d«h õt ) , then the parameter ar ß ° d ONLN dfihtË )h5gument will contain a 32-bit value indicating one or . ° d ONLN du ]Å o (~ ]mor éÄ ° d ONLN du oÅ0 ),e attributes of the installed Speech Manager ° d ONLN dBu0Å÷ )¡(. If the Speech Manager exists, the bit . ° d ONLN djÇ ]é { (ã ]specifi ° d ONLN dqÇ {é ï ) ed by ° d ONLN dwÇ ïé )gestaltSpeechMgrPresent ° d ONLN déÇ é; )ä is set.
± πÈ 4≤ πÈ "≤ _
ˇ·ˇ‚ˆA . ° d ONLN dóß ]≤ â (Ø ] Listing 1-1 ° d ONLN d£ß °≤] )D.Determining if the Speech Manager is available
. ° d ONLN d”¡ ]Õ ( ] Boolean SpeechAvailable (void) { ° d ONLN dıœ o€ ç +OSErr ° d ONLN d˝œ •€ Ω )6err; ° d ONLN d› oÈ á (Ê olong ° d ONLN d
› •È œ )6result; ° d ONLN dÎ o˜k (Ù o*err = Gestalt(gestaltSpeechAttr, &result); ° d ONLN d?˘ o5 *!if ((err != noErr) || !(result & ° d ONLN dd ìS +$ (1 << gestaltSpeechMgrPresent))) ° d ONLN dá Å! œ ( Åreturn FALSE; ° d ONLN dñ# o/ á (, oelse ° d ONLN dù1 Å= … + return TRUE; ° d ONLN d™? ]K c (H ]} ˇä ◊# ˇ ˇˇˇˇ # ◊
ˇ·ˇ‚ˆA ° d ONLN d ; { I ß ( E {Which V ÇÄ ° d ONLN d ; ß Iã ),(ersion of the Speech Manager Is Running? ˇˇˇˇˇˇ ‘@ ( E 1
° d ONLN d 1 O { [Ì ( X {QOnce you have determined that the Speech Manager is installed, you can see which . ° d ONLN d Ç \ { h *"version of the Speech Manager is r l ° d ONLN d § \ hd )õunning by calling ,
Courier l ° d ONLN d ∂ \d h‹ )NSpeechManagerVersion l ° d ONLN d \‹ hfl )x.
ò 9 ° 4 ô 9 † ö 9 ö
ˇ·ˇ‚ˆA . ° d ONLN d à ã 9 ô ö ( ï 9SpeechManagerV } ° d ONLN d ⁄ ã ô ô ∫ )`ersion ˇˇˇˇˇˇ ( ï1
° d ONLN d ‚ ™ { ∂† ( ≥ {BReturns the version of the Speech Manager installed in the system. . ° d ONLN d% √ { œ Á *pascal NumVersion ° d ONLN d7 √ Á œè )l SpeechManagerVersion (void); . ° d ONLN dT Î 9 Ù r ( Ú 9 DESCRIPTION
. ° d ONLN d` ¯ { Û +BSpeechManagerVersion ° d ONLN dt ¯ Û ˘ )x r R` ° d ONLN dv ¯ ˘˛ ):eturns the version of the Speech Manager installed in the . ° d ONLN d∞ {¡ ( {Jsystem. This call should be used to determine the compatibility of your pr £‡ ° d ONLN d˙¡˜ (¡ ogram with ° d ONLN d { ù ( {the curr ` ° d ONLN d û ( )# ently installed Speech Manager ª‡ ° d ONLN d+' ) )â. ° d ONLN d-9 9B S (@ 9RESUL ëÄ ° d ONLN d29 SB w )T CODES
° d ONLN d:F {R ì +(None
q 9x 4q 9w r {r
ˇ·ˇ‚ˆA ° d ONLN d?c {q Ê * Making Some Noise ˇˇˇˇˇˇ ‘@ (m 1
. ° d ONLN d ‡ {Ï è (È {The ° d ONLN d‡ èÏ — ) SpeakString ° d ONLN d‡ —Ï> )B function passes a specifi ° d ONLN d2‡>ÏÏ )m)c text string to be spoken to the Speech . ° d ONLN d[Ì {˘ ¢ (ˆ {Manager T† ° d ONLN dbÌ ¢˘ § )'. . ° d ONLN dd { … ( {pascal OSErr ° d ONLN dq …è )N!SpeakString (StringPtr myString);
9. 4 9. . ° d ONLN dì {* « (' {Field descriptions
ˇ·ˇ‚ˆA
. ° d ONLN d¶, {8 ´ *myString . ° d ONLN dØ, ◊8 › )\T µ¿ ° d ONLN d∞, ‹8? )ext string to be spoken ° d ONLN d»Q 9Z r (X 9 DESCRIPTION
. ° d ONLN d‘_ {k Ω +B SpeakString ° d ONLN dfl_ Ωk» )B= attempts to speak the Pascal-style text string contained in ° d ONLN d _»k¯ (h»myString ° d ONLN d$_¯k˝ )0. . ° d ONLN d&l {x ∞ (u { Speech is pr É@ ° d ONLN d2l ∞x ˆ )5oduced asynchr ï` ° d ONLN d@l ˆx )F<onously using the default system voice. When an application ° d ONLN d|y {Ö‹ (Ç {Pcalls this function, the Speech Manager makes a copy of the passed string and cr ¿ ° d ONLN dÃy›Öı (Ç›eates ° d ONLN d“Ü {í ô (è {any str æÄ ° d ONLN dŸÜ ôí ∞ ) uctur D` ° d ONLN dfiÜ ±í ¿ )es r ê ° d ONLN d‚Ü ¿í ◊ )equir ß@ ° d ONLN dÁÜ ◊í )ed to speak it. (¿ ° d ONLN d˜Üíº )@$As soon as speaking has begun, contr I‡ ° d ONLN dÜºí‘ )•ol is r í ° d ONLN d"Ü‘í ) eturned to ° d ONLN d-ì {üä (ú {=the application. The synthesized speech is generated transpar ߆ ° d ONLN djìäü˛ (úä ently to the application so ˇ> ◊# ˇ ˇˇˇˇ # ◊
° d ONLN d ; ] G ù ( D ]that normal pr ì ° d ONLN d ; ù Gπ )@Aocessing can continue while the text is being spoken. No further ° d ONLN d O H ] T ( Q ](interaction with the Speech Manager is r ›‡ ° d ONLN d w H T& )≤equir ı ° d ONLN d | H& T÷ )+ed at this point, and the application is fr ` ° d ONLN d ß H◊ T„ )±ee ° d ONLN d ™ U ] a l ( ^ ]to r |‡ ° d ONLN d Æ U l a § )elease or pur 5Ä ° d ONLN d ª U • a( )9 ge or trash the original string. . ° d ONLN d ‹ g ] s g ( p ]If ,
ˇ·ˇ‚ˆA ° d ONLN dT ]. +BC#Determining If Speaking Is Complete ˇˇˇˇˇˇ ‘@ (*‚1
. ° d ONLN dy4 ]@ (= ]&Once an application starts a speech pr R` ° d ONLN dü4 @: )¨ ocess with R` ° d ONLN d™4:@| )1 SpeakString R` ° d ONLN dµ4|@„ )B, the next thing it will . ° d ONLN dŒA ]M f (J ]pr G ° d ONLN d–A gM— )
Qobably need to know is whether the string has been completely spoken. It can use . ° d ONLN d!N ]Z ô (W ]
SpeechBusy ° d ONLN d+N ôZö )<: to determine whether or not the system is still speaking.
ä ìÈ 4ã íÈ å åÔ
ˇ·ˇ‚ˆA . ° d ONLN df} ã ] (á
SpeechBusy ˇˇˇˇˇˇ (á„1
. ° d ONLN drú ]® j (• ]Th ° d ONLN dtú j® p )e ° d ONLN duú p® r ) ° d ONLN dvú r® Æ )
SpeechBusy ° d ONLN d9˜ ô ü )< r R` ° d ONLN d;˜ ür )/eturns the number of channels of speech that ar $¿ ° d ONLN dj˜rä )”e curr ˜ ° d ONLN dp˜âfl )ently synthesizing ˇˇÏN ° d ONLN dÉ ] ( ]+speech in the application. If you use just ˇˇƒÍ ‚p ° d ONLN dÆT )µ SpeakString ˇˇÏN ‚p ° d ONLN dπT™ )B to initiate speech, ˇˇƒÍ ì® ° d ONLN dŒ´Á )W
SpeechBusy ˇˇÏN ì® ° d ONLN dÿÁË )< ° d ONLN dŸ ] õ ( ]will always r R` ° d ONLN dÊ õ 7 )>%eturn 1 as long as speech is being pr $¿ ° d ONLN d 7 y )úoduced. When $¿ ° d ONLN dy µ )B
SpeechBusy $¿ ° d ONLN d"µ ª )< r ˜ ° d ONLN d$∫ · )
eturns 0, . ° d ONLN d. ]* … (' ]all initiated speech has fi tÄ ° d ONLN dI * Ï )mnished. ° d ONLN dRE N 5 (L RESUL ëÄ ° d ONLN dWE 5N Y )T CODES
° d ONLN d_R ]^ u +(None
} ÑÈ 4} ÉÈ ~ ]~È
ˇ·ˇ‚ˆA ° d ONLN ddo ]} e * A ÿ@ ° d ONLN deo d} æ ) Simple Example ˇˇˇˇˇˇ ‘@ (y‚1
° d ONLN dvÉ ]è √ (å ]The example shown in ° d ONLN dãÉ ƒè Ú )g Listing 1-2 º` ° d ONLN dñÉ Úèy ). demonstrates how to use the r }Ä ° d ONLN d¥Ézè¨ )à outines intr > ° d ONLN d¿É≠è€ )3
oduced in ° d ONLN d ê ]ú ¢ (ô ]this section. It fi O@ ° d ONLN d›ê £ú fi )Frst makes sur 4 ° d ONLN dÍê fiú );=e the Speech Manager is available. Then it starts speaking a . ° d ONLN dÕ Ó ] ˙ { ( ˜ ]noErr . ° d ONLN d” Ó · ˙ Ê )Ñ0 ° d ONLN d’ Ó ˙ ˙ )No err E† ° d ONLN d€ Ó ˙ ) or . ° d ONLN dfl ˘ ] ô ( ]
memFullErr . ° d ONLN dÍ ˘ “ Ê )u–108 ° d ONLN dÔ ˘ ˙~ )(Not enough memory to speak . ° d ONLN d ] ∑ ( ]synthOpenFailed . ° d ONLN d “ Ê )u–241 ° d ONLN d ˙fi )(1Could not open another speech synthesizer channel ˇ8 ◊# ˇ ˇˇˇˇ # ◊
Courier ° d ONLN d ± U ° a ˚ )&SpeechAvailable ° d ONLN d ¿ U ˚ a )Z r R` ° d ONLN d ¬ U aI )outine shown in R` ° d ONLN d “ UI ay )H Listing 1-1 R` ° d ONLN d › Uy a| )0.
Ñ 9 å 4 Ö 9 å " Ö 9_
ˇ·ˇ‚ˆA . ° d ONLN d fl z { Ö ß ( Ç { Listing 1-2 ° d ONLN d Î z ø ÖH )D Elementary Speech Manager calls
. ° d ONLN d î { † ∑ ( ù {
OSErr err; ° d ONLN d ¢ { Æ *if (SpeechAvailable()) { ° d ONLN d1 ∞ ç ºß +/err = SpeakString("\pThe cat sat on the mat."); ° d ONLN db æ ç Û *if (err == noErr) ° d ONLN dv à ü ÿ/ +while (SpeechBusy() > 0) ° d ONLN dí ⁄ ± Ê; +CoolAnimationRoutine(); ° d ONLN d´ Ë ç Ù • ( Ò çelse ° d ONLN d≤ ˆ üA +NotSoCoolAlertRoutine(err); ° d ONLN dŒ { Å ( {}
6 9= 47 9= 8 {8
ˇ·ˇ‚ˆA ˇˇ‹. . ˇ◊ ° d ONLN d–' {6Q *%!Essential Calls—Simple and Useful ˇˇˇˇˇˇ €r (2ˇ1
° d ONLN dÛ= {I ¨ (F { While the r é ° d ONLN d˛= ¨I ÿ )1
outines pr T† ° d ONLN d= ŸIU )- esented in the last section ar J` ° d ONLN d&=UIˆ )|(e simple to use, their applicability is ° d ONLN dNJ {V¿ (S {Llimited to a few basic speech scenarios. This section describes additional r £ ° d ONLN döJ¿V (S¿outines that let ° d ONLN d´W {c À (` {you work with dif ◊Ä ° d ONLN dºW Àc ◊ )Pfer ∫ ° d ONLN døW ◊c¸ ) Dent voices and adjust some basic characteristics of the synthesized ° d ONLN dd {p õ (m {speech.
é 9ï 4è 9ï ê {ê
ˇ·ˇ‚ˆA ° d ONLN d Å {è Ü * W ú¿ ° d ONLN d Å Üè µ ) orking W Ò ° d ONLN dÅ µè Õ )/ith V I¿ ° d ONLN dÅ Õè È )oices ˇˇˇˇˇˇ ‘@ (ã 1
° d ONLN d ï {° (û {[When describing a person’s voice, we talk about the particular set of characteristics that ° d ONLN d{¢ {Æ9 *-help us to distinguish that person’s voice fr ?@ ° d ONLN d®¢:Æl )ø
! ‰- )i ovides two r & ° d ONLN d!-ô )7 outines to count and step thr Ó‡ ° d ONLN d3!ô-› )~ough the list of . ° d ONLN dD. {: å (7 {curr R` ° d ONLN dH. å: ˜ )ently available voices. R` ° d ONLN d`. ˜:9 )k CountVoices R` ° d ONLN dk.9:Ê )B& is used to compute how many voices ar $¿ ° d ONLN dë.Ê:Ì )≠e ° d ONLN dì; {G Á (D {available with the curr R` ° d ONLN d™; ÁG )l ent system. R` ° d ONLN d∂;G] )4 GetIndVoice R` ° d ONLN d¡;]GÈ )B# uses an index, starting at 1, to r $¿ ° d ONLN d‰;ÈG )åeturn . ° d ONLN dÍH {T Ì (Q {information about all curr ¿ ° d ONLN dH ÓTM )sently installed voices. . ° d ONLN d Z {f † (c {Use the ° d ONLN d$Z †f ‚ )% GetIndVoice ° d ONLN d/Z ‚f Ë )B r R` ° d ONLN d1Z Ëf5 )outine to step thr $¿ ° d ONLN dCZ5fÙ )M,ough the list of available voices. It will fi $¿ ° d ONLN dpZÙf )øll a ° d ONLN dug {s ± (p { VoiceSpec ° d ONLN d~g ±s ∑ )6 r R` ° d ONLN dÄg ∑s … )ecor $¿ ° d ONLN dÑg …s )Hd that can be used to obtain descriptive information about the voice or . ° d ONLN dÃt {Ä Í (} {to speak using that voice. ° d ONLN dÁÜ {íy *:Any application that wishes to use multiple voices will pr C` ° d ONLN d!Üzí‚ )ˇobably need additional . ° d ONLN d8ì {üb (ú {2information about the available voices beyond the ° d ONLN djìbüò )Á VoiceSpec ° d ONLN dsìòü¶ )6 str l ° d ONLN dwì¶üº )uctur >` ° d ONLN d|ìºü˙ )e, such as the ˇî ◊# ˇ ˇˇˇˇ # ◊
° d ONLN d ; ] G œ ( D ]name of the voice and per —† ° d ONLN d ; œ GÀ )r8haps what script and language each voice supports. This ° d ONLN d Q H ] T « ( Q ]information might be pr 3 ° d ONLN d h H » TÁ )kBesented to the user in a “voice picker” dialog box or voice menu, ° d ONLN d ™ U ] a^ ( ^ ]<or it might be used internally by an application trying to fi « ° d ONLN d Á U^ afi ( ^^ nd a voice that meets certain . ° d ONLN d b ] n Ö ( k ]
criteria. !† ° d ONLN d b Ö n ˆ )(Applications can use the ,
Courier !† ° d ONLN d( b ˆ nh )qGetVoiceDescription !† ° d ONLN d; bh nn )r r Ù ° d ONLN d= bm nfl )outine for these purposes.
û ßÈ 4 ü ¶È † †Ô
ˇ·ˇ‚ˆA . ° d ONLN dX ë ü C ( õ MakeV ’Ä ° d ONLN d] ë B ü q )'oiceSpec ˇˇˇˇˇˇ ( õ„1
° d ONLN dg ∞ ] º c ( π ]T µ¿ ° d ONLN dh ∞ b º )#o maximize compatibility with futur K¿ ° d ONLN dã ∞ ºñ )° e versions of the Speech Manager 3@ ° d ONLN d´ ∞ñ ºœ )ì, you should . ° d ONLN d∏ Ω ] … ë ( Δ ] always use ° d ONLN d√ Ω ë … fl )4MakeVoiceSpec ° d ONLN d– Ω fl …J )N instead of setting the fi ° d ONLN dÍ ΩJ …| )k elds of the ° d ONLN dˆ Ω| …≤ )2 VoiceSpec ° d ONLN dˇ Ω≤ …¿ )6 str l ° d ONLN d Ω¿ …÷ )uctur >` ° d ONLN d Ω÷ …› )e . ° d ONLN d
] ÷ i ( ” ]dir I ° d ONLN d j ÷ ~ )ectly ! ° d ONLN d ~ ÷ Ä ). . ° d ONLN d „ ] Ô ´ ( Ï ]pascal OSErr ° d ONLN d! „ ´ Ô„ )N4MakeVoiceSpec (OSType creator, OSType id, VoiceSpec ° d ONLN dU Ò ] ˝ ç ( ˙ ]*voice); ° d ONLN d^ ] ˘ *typedef struct VoiceSpec { ° d ONLN dz o# ì +OSType ° d ONLN dÉ •# ’ )6creator; ° d ONLN då ’# € )0 ° d ONLN dé €#„ ),// determines which synthesizer is required ° d ONLN dº% o1 ì (. oOSType ° d ONLN d≈% •1 ∑ )6id; ° d ONLN d % …1 œ )$ ° d ONLN dÃ% €1≠ )#// voice ID on the specified synth ° d ONLN d3 ]? • (< ] } VoiceSpec;
. ° d ONLN dY ]e á *creator . ° d ONLN dY πe )\The synthesizer r ]@ ° d ONLN d)Ye )Lequir tÄ ° d ONLN d.Y eÄ )ed by your application . ° d ONLN dEh ]t i (q ]id . ° d ONLN dHh πt Ÿ )\Identifi ÿ ° d ONLN dPh ŸtU ) cation number for this voice . ° d ONLN dmw ]É Å (Ä ]*voice ° d ONLN dtw πÉ ˘ )\Pointer to the ° d ONLN dÉw ˘É/ )@ VoiceSpec ° d ONLN dåw/É= )6 str l ° d ONLN dêw=ÉS )uctur >` ° d ONLN dïwSÉX )e . ° d ONLN dóù ¶ T (§ DESCRIPTION
. ° d ONLN d£™ ]∂ Œ +BMost voice management r R` ° d ONLN d∫™ Œ∂Ö )q+outines expect to be passed a pointer to a R` ° d ONLN d™Ö∂¡ )∑
VoiceSpec ° d ONLN dÔ∑ ]√ i (¿ ]str l ° d ONLN dÚ∑ i√ ) uctur >` ° d ONLN d˜∑ √ â )e. >` ° d ONLN d˙∑ â√ ◊ )
MakeVoiceSpec >` ° d ONLN d∑ ◊√ )N is a utility r ¿ ° d ONLN d∑√8 )9 outine pr „ ° d ONLN d ∑7√≠ )'ovided to facilitate the cr µÄ ° d ONLN d:∑≠√◊ )v
eation of ° d ONLN dDƒ ]– ì (Õ ] VoiceSpec ° d ONLN dMƒ ì– ô )6 r R` ° d ONLN dOƒ ô– ´ )ecor $¿ ° d ONLN dSƒ ´– Õ )ds. On r ˜ ° d ONLN d[ƒ Ö )!eturn, the passed ˜ ° d ONLN dmƒ–Q )O VoiceSpec ˜ ° d ONLN dvƒQ–_ )6 str „ ° d ONLN dzƒ_–u )uctur µÄ ° d ONLN dƒu–µ )e contains the . ° d ONLN dé— ]› q (⁄ ]appr I@ ° d ONLN dí— r› ≤ )opriate values. . ° d ONLN d¢„ ]Ô e (Ï ]V d@ ° d ONLN d£„ dÔ Ü )oices ar 6† ° d ONLN d´„ ÜÔ û )"e stor ° d ONLN d±„ ûÔ ∫ )ed in r €` ° d ONLN d∏„ πÔ – )esour ≠¿ ° d ONLN dΩ„ –Ô ) ces of type ≠¿ ° d ONLN d…„Ô% )1'ttsv' ≠¿ ° d ONLN dœ„%ÔH )$ in the r Ä ° d ONLN dÿ„HÔ_ )#esour RÄ ° d ONLN d›„_Ô√ )ce fork of Macintosh fi RÄ ° d ONLN dÙ„√ÔÈ )d les. The . ° d ONLN d˝ ]¸ ˙ (˘ ]!Speech Manager uses the same sear w ° d ONLN d ˙¸f )ùch method as the Resour ° d ONLN d5g¸ö )m
ce Manager öÄ ° d ONLN d?ô¸— )2, looking for . ° d ONLN dM˝ ] { ( ]voice r R` ° d ONLN dT˝ { í ) esour $¿ ° d ONLN dY˝ í ª )
ces in thr ˜ ° d ONLN dc˝ ∫ ‘ )(ee dif …Ä ° d ONLN di˝ ‘ · )fer õ‡ ° d ONLN dl˝ · { )"ent locations when attempting to r n@ ° d ONLN dé˝{ ö )öesolve n@ ° d ONLN dï˝ö – ) VoiceSpec n@ ° d ONLN dû˝– “ )6 . ° d ONLN dü
] ` ( ]r E ° d ONLN d†
a q )efer Ò ° d ONLN d§
q ù ) ences. It fi 0† ° d ONLN d∞
û )- rst looks in the application’s r Ÿ` ° d ONLN d–
8 )Çesour !† ° d ONLN d’
9J )ce fi Ë@ ° d ONLN d⁄
Jß )le chain. If the specifi Ä ° d ONLN dÚ
®ÿ )^ ed voice is ° d ONLN d˛ ]# ¬ ( ]not found in an open fi Ò` ° d ONLN d ¬#Á )eEle, it then looks in the System Folder and the Extensions folder (or . ° d ONLN dZ$ ]0- (- ]/in just the System Folder under System 6) for fi ° d ONLN dä$-0^ )– les of type ° d ONLN dñ$^0Ç )1'ttsv' ° d ONLN dú$Ç0» )$ (single-voice fi ° d ONLN d≠$»0Ê )Fles) or ° d ONLN dµ1 ]= Å (: ]'ttsb' ° d ONLN dª1 Å= æ )$ (multivoice f PÄ ° d ONLN d…1 æ=£ )=3iles) and in text-to-speech synthesizer component f ! ° d ONLN d¸1£=æ )Âiles (f ÒÄ ° d ONLN d1Ω=„ ) ile type ° d ONLN d > ]J Å (G ]'INIT' ° d ONLN d> ÅJ é )$ or ° d ONLN d> éJ ≤ )'thng' ° d ONLN d > ≤J √ )$). V d@ ° d ONLN d > ¬J Î )
oices stor 6† ° d ONLN d*> ÎJº ))/ed in the System Folder or Extensions folder ar ° d ONLN dY>ºJ√ )—e . ° d ONLN d[K ]W (T ])normally available to all applications. V 6‡ ° d ONLN dÑK W5 )Ø
oices stor EÄ ° d ONLN déK5Wa )) ed in the r ° d ONLN dôKbWz )-esour O@ ° d ONLN dûKzWÁ )ce fork of an application ° d ONLN d∏X ]d c (a ]fi å¿ ° d ONLN d∫X cd z )les ar ¿¿ ° d ONLN d¿X zd Û ) e private to the application. ˇfi ◊# ˇ ˇˇˇˇ # ◊
° d ONLN d Z { f +(!!While the determination of specifi ‰ ° d ONLN d @ Z fŸ )ñ0c voice ID values is mostly left to synthesizer . ° d ONLN d p g { s fi ( p {developers, the voice ,
Courier ° d ONLN d Ü g fi s )ccreator ° d ONLN d ç g s4 )*
values ar R` ° d ONLN d ó g4 sY ),e specifi R` ° d ONLN d † gY ss )%ed by Ù ° d ONLN d ¶ gr s‘ )Apple (they would or Δ` ° d ONLN d ∫ g‘ s˝ )b dinarily ° d ONLN d √ t { Ä å ( } {corr R` ° d ONLN d « t å Ä Ó )espond to a developer ¿ ° d ONLN d ‹ t Ô Ä )c’s curr ‚ ° d ONLN d „ t ÄS )ently assigned cr ¥Ä ° d ONLN d Ù tS ĺ )Keator ID). For both the ¥Ä ° d ONLN d tº ÄÊ )icreator ¥Ä ° d ONLN d tÊ Ä˚ )* and ° d ONLN d Å { ç á ( ä {id ° d ONLN d Å á ç ç ) f PÄ ° d ONLN d Å ç ç ¶ )ields Ú ° d ONLN d" Å • ç Î )Apple further r ƒÄ ° d ONLN d1 Å Î ç: )Feserves the set of ƒÄ ° d ONLN dD Å: ç^ )OOSType ƒÄ ° d ONLN dJ Å^ çõ )$ values specif ï ° d ONLN dX Åõ ç¬ )= ied entir g` ° d ONLN da Ŭ ç˚ )'ely by space . ° d ONLN dn é { ö ◊ ( ó {characters and lower ê¿ ° d ONLN dÇ é ◊ ö )\case letters. Y@ ° d ONLN dê é öì )5 Apple is establishing a standar &@ ° d ONLN dØ éî ö )àd suite of voice ID values ° d ONLN d õ { ßà ( § {Lthat developers can count upon being available with all speech synthesizers.
◊ 9 ‡ 4 ÿ 9 fl Ÿ 9 Ÿ
ˇ·ˇ‚ˆA ° d ONLN d 9 ÿ d ( ‘ 9CountV }¿ ° d ONLN d c ÿ ~ )*oices ˇˇˇˇˇˇ ( ‘1
. ° d ONLN d$ È { ı è ( Ú {The ° d ONLN d( È è ı — ) CountVoices ° d ONLN d3 È — ı ◊ )B r R` ° d ONLN d5 È ◊ ı ˘ )outine r $¿ ° d ONLN d= È ˘ ı§ )"&eturns the number of voices available. ° d ONLN dd { … ( {pascal OSErr ° d ONLN dq …â )N CountVoices (short *voiceCount);
9+ 4 9* . ° d ONLN dí {& « (# {Field descriptions
ˇ·ˇ‚ˆA
. ° d ONLN d•( {4 ∑ *
voiceCount . ° d ONLN d∞( ◊4ü )\-Number of voices available to the application ° d ONLN dfiN 9W r (U 9 DESCRIPTION
. ° d ONLN dÍ[ {g ´ +B
Each time ° d ONLN dÙ[ ´g Ì )0 CountVoices ° d ONLN dˇ[ Ìgç )B# is called, the Speech Manager sear R` ° d ONLN d"[çg˛ )†ches for new voices. This . ° d ONLN d<h {t€ (q {Palgorithm supports dynamic installation of voices by applications or users. On r Í¿ ° d ONLN dåh€t˜ (q€eturn, . ° d ONLN dìu {Å ç (~ {the ° d ONLN dóu çÅ … )
voiceCount ° d ONLN d°u …Å≤ )<3 parameter contains the number of voices available. . ° d ONLN d’ú 9• S (£ 9RESUL ëÄ ° d ONLN d⁄ú S• w )T CODES
 9Ì 4 9Ì Á 9Á
ˇ·ˇ‚ˆA ° d ONLN dÙ◊ 9 i (· 9GetIndV —@ ° d ONLN d˚◊ h } )/oice ˇˇˇˇˇˇ (·1
. ° d ONLN d˜ { è ( {The ° d ONLN d˜ è — ) GetIndVoice ° d ONLN d˜ — ◊ )B r R` ° d ONLN d˜ ◊ ˘ )outine r $¿ ° d ONLN d˜ ˘è )"!eturns information about a specifi $¿ ° d ONLN d<˜è∞ )ñc voice. ° d ONLN dE { … ( {pascal OSErr ° d ONLN dR … — )N,GetIndVoice (short index, VoiceSpec *voice);
. ° d ONLN dí6 {B ô *index . ° d ONLN dò6 ◊B@ )\Index value for a specifi G` ° d ONLN d±6AB_ )jc voice . ° d ONLN dπE {Q ü (N {*voice ° d ONLN d¿E ◊Q )\Pointer to the ° d ONLN dœEQM )@ VoiceSpec ° d ONLN dÿEMQ[ )6 str l ° d ONLN d‹E[Qq )uctur >` ° d ONLN d·EqQv )e . ° d ONLN d„j 9s r (q 9 DESCRIPTION
° d ONLN d ; ] G ò ( D ] when voice fi é ° d ONLN d ; ò G ∂ );les or r ™@ ° d ONLN d ; ∂ G Œ ) esour ÚÄ ° d ONLN d ; Œ G Ê )ces ar Æ` ° d ONLN d ; Á G )
e added, r Ÿ‡ ° d ONLN d * ; Gd ),emoved, or modifi ª ° d ONLN d ; ;e Gö )Red is also pr ߇ ° d ONLN d H ;ö Gª )5esently . ° d ONLN d P H ] T y ( Q ]undefi ° d ONLN d V H y T ∏ ) ned. However ¬† ° d ONLN d b H ∑ T fi )>
, calling ,
Courier ¬† ° d ONLN d l H fi T )' CountVoices ¬† ° d ONLN d w H T- )B or ¬† ° d ONLN d { H- To ) GetIndVoice ¬† ° d ONLN d Ü Ho T⁄ )B with an index of 1 will ˇˇ=` ° d ONLN d ü U ] a j ( ^ ]for R` ° d ONLN d ¢ U j at )>ce the Speech Manager to update its list of available voices. ˇ˝∏ ıÄ ° d ONLN d ‡ Ut a∂ ( ^t GetIndVoice ˇˇ=` ıÄ ° d ONLN d Î U∂ a– )B will r B† ° d ONLN d Ú U— aÈ )eturn ° d ONLN d ¯ b ] n e ( k ]a ° d ONLN d ˙ b e n ≥ )voiceNotFound ° d ONLN d b ≥ n ¬ )N err R` ° d ONLN d b ¬ n‘ )=or if the passed index value exceeds the number of available . ° d ONLN dH o ] { z ( x ]voices. ° d ONLN dP ï û 5 ( ú RESUL ëÄ ° d ONLN dU ï 5 û Y )T CODES
È ÚÈ 4 Í ÒÈ Î ÎÔ
ˇ·ˇ‚ˆA ° d ONLN dú ‹ Í 8 ( Ê GetV }Ä ° d ONLN d† ‹ 7 Í ç ) oiceDescription ˇˇˇˇˇˇ ( Ê„1
. ° d ONLN d± ˚ ] q ( ]The ° d ONLN dµ ˚ q „ )GetVoiceDescription ° d ONLN d» ˚ „ È )r r R` ° d ONLN d ˚ È )outine r $¿ ° d ONLN d“ ˚ ÷ )"-eturns information about a voice beyond that ° d ONLN dˇ ] g ( ]pr R` ° d ONLN d g ñ )
. ° d ONLN dW1 ]= Å **voice ° d ONLN d^1 π= ˘ )\Pointer to the ° d ONLN dm1 ˘=/ )@ VoiceSpec ° d ONLN dv1/== )6 str l ° d ONLN dz1==S )uctur >` ° d ONLN d1S=X )e ° d ONLN dÅ@ ]L { (I ]*info . ° d ONLN dá@ πL Ú )\Pointer to str Õ` ° d ONLN dï@ ÚL )9uctur S@ ° d ONLN dö@
infoLength ° d ONLN d’O π[ )\Length in bytes of ° d ONLN dËO [# )Rinfo ° d ONLN dÏO#[1 ) str l ° d ONLN dO1[G )uctur >` ° d ONLN dıOG[L )e . ° d ONLN d˜u ~ T (| DESCRIPTION
. ° d ONLN dÇ ]é ≈ +BThe Speech Manager fi ° d ONLN dÇ ≈é )hlls out the passed ° d ONLN d+Çév )QVoiceDescription ° d ONLN d;Çvé )` fi ° d ONLN d>Çé– ) elds with the corr R` ° d ONLN dPÇ–éfl )Qect ° d ONLN dTè ]õ ‘ (ò ]information for the specifi ° d ONLN doè ‘õ$ )wed voice. If a null ° d ONLN dÉè$õZ )P VoiceSpec ° d ONLN dåèZõ‚ )6 pointer is passed, the Speech ° d ONLN d\ £ ] Ø { ( ¨ ]noErr . ° d ONLN db £ ‘ Ø Ÿ )w0 ° d ONLN dd £ Ì Ø )No err E† ° d ONLN dj £
Ø ) or . ° d ONLN dn Æ ] ∫ ´ ( ∑ ]voiceNotFound . ° d ONLN d| Æ ≈ ∫ Ÿ )h–244 ° d ONLN dÅ Æ Ì ∫ Ù )(V ú` ° d ONLN dÇ Æ Û ∫ )oice r y ° d ONLN dà Æ ∫# )esour ¡` ° d ONLN dç Æ# ∫Z ) ce not found ˇÊ ◊# ˇ ˇˇˇˇ # ◊
Courier R` ° d ONLN d A ;ù G˝ )ÙVoiceDescription R` ° d ONLN d Q ;˝ Gˇ )` ˇˇçZ ° d ONLN d R H { TV ( Q {0pointer is null, the Speech Manager simply verifi ]v ° d ONLN d É HW Tß )‹es that the specifi Ñ ° d ONLN d ñ H® T¥ )Qed ˇ˛® ífi ° d ONLN d ô H¥ TÍ ) VoiceSpec ˇˇçZ ífi ° d ONLN d ¢ HÍ TÔ )6 r Úò ° d ONLN d § HÔ T )efers ° d ONLN d ™ U { a Í ( ^ {to an available voice. If ° d ONLN d ƒ U Í a )o VoiceSpec ° d ONLN d Õ U aL )6 does not r R` ° d ONLN d ÿ UL aØ ),efer to a known voice, ° d ONLN d Ô b { n Ì ( k {GetVoiceDescription ° d ONLN d b Ì n Û )r r R` ° d ONLN d b Û n ) eturns a R` ° d ONLN d b nf )%voiceNotFound R` ° d ONLN d bf nu )N err $¿ ° d ONLN d bu n~ )or g` ° d ONLN d b} n∏ ), as shown in g` ° d ONLN d. b∏ nË ); Listing 1-3 g` ° d ONLN d9 bË nÎ )0. . ° d ONLN d; t { Ä Å ( } {T µ¿ ° d ONLN d< t Ä Ä )#o maximize compatibility with futur K¿ ° d ONLN d_ t! Ä¥ )° e versions of the Speech Manager 3@ ° d ONLN d t¥ Ä˝ )ì, the application ˇˇ…¯ . ° d ONLN dë Å { ç È ( ä {must pass the size of the ˇˇ]Ë ;– ° d ONLN d´ Å Í çJ )oVoiceDescription ˇˇ…¯ ;– ° d ONLN dª ÅJ çW )` str Ò» ° d ONLN dø ÅW çm )uctur ƒ( ° d ONLN dƒ Åm ç )"e. Having the application do this . ° d ONLN dÊ é { ö ì ( ó {ensur $ ° d ONLN dÎ é î öj )/es that the Speech Manager will never write mor a ° d ONLN d éj ö◊ )÷e data into the passed str ` ° d ONLN d4 éÿ öÔ )nuctur ù@ ° d ONLN d9 éÔ öˆ )e ° d ONLN d; õ { ß ´ ( § { than will fi Ç ° d ONLN dG õ ´ ß> )0"t even if additional information fi ÕÄ ° d ONLN dj õ> ß[ )ìelds ar @ ° d ONLN dq õ\ ßt ) e defi Y ° d ONLN dw õt ßπ )ned in the futur ê` ° d ONLN dá õπ ß÷ )Ee. On r L@ ° d ONLN dé õ◊ ߡ ) eturning ˇˇÃ . ° d ONLN dó ® { ¥ É ( ± {fr R` ° d ONLN dô ® É ¥ ë )om ˇ˝Jd k, ° d ONLN dú ® ë ¥ )GetVoiceDescription ˇˇÃ k, ° d ONLN dØ ® ¥> )r, the length fi µê ° d ONLN dæ ®> ¥s );eld is set to r Î ° d ONLN dÕ ®s ¥ )5efl Î ° d ONLN d– ® ¥ ) ect the length of data actually . ° d ONLN d µ { ¡ ¬ ( æ {written by this r f† ° d ONLN d µ ¬ ¡ ‡ )Goutine.
‰ 9 Ï 4 Â 9 Ï " Â 9_
ˇ·ˇ‚ˆA ° d ONLN d ⁄ { Â ß ( ‚ { Listing 1-3 ° d ONLN d ⁄ ø ÂC )D!Getting information about a voice
. ° d ONLN d8 Ù { › ( ˝ {;OSErr GetVoiceGender (VoiceSpec *voicePtr, short *gender) { ° d ONLN du ç ´ +OSErr ° d ONLN d~ ’ Ì )Herr; ° d ONLN dÑ ç Ì ( çVoiceDescription ° d ONLN dñ Ì ˇ )`vd; ° d ONLN dõ ç*# (' çerr = GetVoiceDescription ° d ONLN d∑, ü8è +((voicePtr,&vd,sizeof(VoiceDescription)); ° d ONLN d·: çF ˇ (C çif (err == noErr) { ° d ONLN d˜H üTÀ +2if (vd.length > offsetof(VoiceDescription,gender)) ° d ONLN d-V ±b) +*gender = vd.gender; ° d ONLN dDd üp ∑ (m üelse ° d ONLN dLr ±~# +err = badStructLen; ° d ONLN daÄ çå ì (â ç} ° d ONLN ddé çö œ * return err; ° d ONLN dpú {® Å (• {} . ° d ONLN dr√ 9à S ( 9RESUL ëÄ ° d ONLN dw√ Sà w )T CODES
9" 4 9" {
ˇ·ˇ‚ˆA ° d ONLN d { w +(N+Managing Connections to Speech Synthesizers ˇˇˇˇˇˇ ‘@ ( 1
° d ONLN dF" {. ¨ (+ { Using the r oÄ ° d ONLN dQ" ¨. )1Poutines described earlier in this document, an application can select the voice ° d ONLN d°/ {;÷ (8 {Qwith which to speak. The next step is to associate the selected voice with the pr ° d ONLN dÚ/◊;Ì (8◊oper ° d ONLN d˜< {H Õ (E {speech synthesizer ≥ ° d ONLN d < ÕHF )R . This is accomplished by cr ,† ° d ONLN d%<GHÓ )z%eating a new speech channel with the . ° d ONLN dJI {U € (R {NewSpeechChannel ° d ONLN dZI €U · )` r R` ° d ONLN d\I ·U )outine. Ù ° d ONLN ddIU ) A g` ° d ONLN deI U˛ )6 speech channel is a private communication connection . ° d ONLN dõV {b È (_ {to the speech synthesizer H` ° d ONLN d¥V Èb" )n, much as a fi .‡ ° d ONLN d¬V#b1 ):le r %‡ ° d ONLN dΔV1bA )efer “ ° d ONLN d VAb )*ence number is a communication channel to ° d ONLN dÙc {o ¶ (l { an open fi p¿ ° d ONLN d˛c ßo ),le in the Macintosh fi , ° d ONLN dco/ )]
le system. . ° d ONLN d u {Å è (~ {The ° d ONLN d#u èÅ )DisposeSpeechChannel ° d ONLN d7uÅ )x r R` ° d ONLN d9uÅ )7outine closes a speech channel when the application is . ° d ONLN dpÇ {é Å (ã {fi å¿ ° d ONLN drÇ Åé ÿ )nished with it and r j@ ° d ONLN dÜÇ ÿé )Weleases any r O ° d ONLN dìÇé( )8esour ó@ ° d ONLN dòÇ(éÊ ),ces that have been allocated to support the ° d ONLN dƒè {õ Ï (ò {speech synthesizer and ar "† ° d ONLN d›è ÌõC )re no longer needed. . ° d ONLN d~— {› ô (⁄ {noErr . ° d ONLN dÑ— Ú› ˜ )w0 ° d ONLN dÜ— ›' )No err E† ° d ONLN då—(›1 ) or . ° d ONLN dê‹ {Ë ´ ( {paramErr . ° d ONLN dô‹ ËË ˜ )m–50 ° d ONLN dù‹ ËG )#Parameter err ¿ ° d ONLN d™‹HËQ )=or . ° d ONLN dÆÁ {Û ∑ ( {
memFullErr . ° d ONLN dπÁ „Û ˜ )h–108 ° d ONLN dæÁ Ûfi )(+Not enough memory to load voice into memory . ° d ONLN dÎÚ {˛ … (˚ {voiceNotFound . ° d ONLN d˘Ú „˛ ˜ )h–244 ° d ONLN d˛Ú ˛ )(V ú` ° d ONLN dˇÚ˛) )oice r y ° d ONLN dÚ)˛A )esour ¡` ° d ONLN d
ˇ·ˇ‚ˆA ° d ONLN d ; I ä ( E NewSpeechChannel ˇˇˇˇˇˇ ( E„1
. ° d ONLN d Z ] f q ( c ]The ,
Courier ° d ONLN d Z q f — )NewSpeechChannel ° d ONLN d & Z — f ◊ )` r R` ° d ONLN d ( Z ◊ f ˝ ) outine cr $¿ ° d ONLN d 1 Z ˝ f{ )&eates a new speech channel. ° d ONLN d M s ] ´ ( | ]pascal OSErr ° d ONLN d Z s ´ É )N$NewSpeechChannel (VoiceSpec *voice, ° d ONLN d Ä Å o ç Ì ( ä oSpeechChannel *chan);
e is no pr Ÿ∏ ° d ONLN d[" ò. Ø )%edefi Ÿ∏ ° d ONLN d`" Ø.f ))ned limit to the number of speech channel ˇ˛¥¯ ’P ° d ONLN dâ"g.m )∏s ˇˇë® ’P ° d ONLN dä"m.– ) an application may cr ÓP ° d ONLN d†"–.Ë )ceate. . ° d ONLN d¶/ ]; Ü (8 ]However † ° d ONLN d≠/ Ü;> ))), system constraints on available RAM, pr ° d ONLN d÷/>;À )∏ ocessor loading, and number of ° d ONLN dı< ]H” (E ]Savailable sound channels may limit the number of speech channels actually possible. ° d ONLN dIc l 5 (j RESUL ëÄ ° d ONLN dNc 5l Y )T CODES
. ° d ONLN d-fl ]Î q (Ë ]The ° d ONLN d1fl qÎ È )DisposeSpeechChannel ° d ONLN dEfl ÈÎ Ô )x r R` ° d ONLN dGfl ÔΪ ).outine disposes of an existing speech channel. ° d ONLN dv¯ ] ´ ( ]pascal OSErr ° d ONLN dɯ ´ß )N*DisposeSpeechChannel (SpeechChannel chan);
. ° d ONLN d¡ ]* u *chan . ° d ONLN dΔ π* ÷ )\Specifi ‡ ° d ONLN dÕ ÷* ) c speech channel ° d ONLN dfiC L T (J DESCRIPTION
. ° d ONLN dÍQ ]] x +BThis r R` ° d ONLN dQ x]F )/outine disposes of an existing speech channel. Ù ° d ONLN d QE]ü )ÕAny speech channel Ù ° d ONLN d1Qü]• )Zs Ù ° d ONLN d2Q•]Ë ) that have not . ° d ONLN dA^ ]j0 (g ]1been explicitly disposed of by the application ar ÿ` ° d ONLN dr^0j; )”e r Á ° d ONLN du^;j‹ ) $eleased automatically by the Speech ° d ONLN dôk ]w ˇ (t ]#Manager when the application quits. . ° d ONLN dUp ]| { (y ]noErr . ° d ONLN d[p ‹| · )0 ° d ONLN d]p ı| )No err E† ° d ONLN dcp| ) or . ° d ONLN dg{ ]á ô (Ñ ]
memFullErr . ° d ONLN dr{ Õá · )p–108 ° d ONLN dw{ ı᪠)((Not enough memory to open speech channel . ° d ONLN d°Ü ]í ∑ (è ]synthOpenFailed . ° d ONLN d±Ü Õí · )p–241 ° d ONLN d∂Ü ıíŸ )(1Could not open another speech synthesizer channel . ° d ONLN dÈë ]ù ´ (ö ]voiceNotFound . ° d ONLN d˜ë Õù · )p–244 ° d ONLN d¸ë ıù ¸ )(V ú` ° d ONLN d˝ë ˚ù )oice r y ° d ONLN dëù+ )esour ¡` ° d ONLN dë+ùb ) ce not found ˇ ◊# ˇ ˇˇˇˇ # ◊
ˇ·ˇ‚ˆA ° d ONLN d Y p { ~ +(8 Starting and Stopping Speech ˇˇˇˇˇˇ ‘@ ( z 1
° d ONLN d w Ñ { ê ü ( ç { All the r ∫` ° d ONLN d Ä Ñ ü ê œ )$
emaining r ü† ° d ONLN d ä Ñ œ ê5 )0outines in this section r ø` ° d ONLN d £ Ñ5 êL )fequir ÷† ° d ONLN d ® ÑL êfi )!e a valid speech channel to work ° d ONLN d … ë { ù Ñ ( ö {pr G ° d ONLN d À ë Ö ù ° )
operly ÷¿ ° d ONLN d — ë † ùT )*. Once the application has successfully cr 8‡ ° d ONLN d ˚ ëU ù˙ )µ(eated a speech channel, it can start to . ° d ONLN d# û { ™ õ ( ß {speak. R` ° d ONLN d* û õ ™ ¢ ) Y g` ° d ONLN d+ û ° ™ œ ) ou use the ,
Courier g` ° d ONLN d6 û œ ™ ). SpeakText g` ° d ONLN d? û ™ )6 r 9¿ ° d ONLN dA û ™’ )-outine to begin speaking on a speech channel. . ° d ONLN do ∞ { º ( π {"At any time during the speaking pr ñ ° d ONLN dë ∞ º· )ú/ocess, the application can stop the synthesizer † ° d ONLN d¿ ∞„ ºÏ )Ã’s . ° d ONLN d√ Ω { … ≥ ( Δ { speech. The ° d ONLN dœ Ω ≥ … Ô )8
StopSpeech ° d ONLN dŸ Ω Ô … ı )< r R` ° d ONLN d€ Ω ı …Ÿ )1outine will immediately abort any speech being pr $¿ ° d ONLN d ΩŸ … )‰
oduced on . ° d ONLN d { ÷ ß ( ” {
the specifi KÄ ° d ONLN d! ® ÷ )-ed speech channel and for V¿ ° d ONLN d: ÷æ )s'ce the channel back into an idle state.
9 4 9 9
ˇ·ˇ‚ˆA ° d ONLN db ˘ 9 b ( 9SpeakT * ° d ONLN dh ˘ b q ))ext ˇˇˇˇˇˇ (1
. ° d ONLN dm {$ è (! {The ° d ONLN dq è$ ≈ ) SpeakText ° d ONLN dz ≈$ À )6 r R` ° d ONLN d| À$ñ ).outine converts a designated text into speech. ° d ONLN d´1 {= … (: {pascal OSErr ° d ONLN d∏1 …=È )N0SpeakText (SpeechChannel chan, Ptr textBuf, long ° d ONLN dÍ? çK ’ (H ç byteLength);
Y 9h 4Y 9g . ° d ONLN d˜X {c « (` {Field descriptions
ˇ·ˇ‚ˆA
. ° d ONLN d
e {q ì *chan . ° d ONLN de ◊q Ù )\Specifi ‡ ° d ONLN de Ùq> ) c speech channel . ° d ONLN d't {Ä • (} {textBuf . ° d ONLN d/t ◊Ä Ê )\Buf … ° d ONLN d2t ÊÄ ) fer of text . ° d ONLN d>É {è ∑ (å {
. ° d ONLN dg∂ {¬) +B'In addition to a valid speech channel, ° d ONLN dé∂)¬_ )Æ SpeakText ° d ONLN dó∂_¬˜ )6% expects a pointer to the text to be ˇˇÓ∞ ° d ONLN dº√ {œD (à {.spoken and the length in bytes of the text buf ∂ê ° d ONLN dÍ√DœQ )…fer ˘0 ° d ONLN dÌ√PœT ) . ˇˇÃ Á‡ ° d ONLN dÔ√Uœã ) SpeakText ˇˇÓ∞ Á‡ ° d ONLN d¯√㜠)6 will convert the given text . ° d ONLN d– {‹ Ü (Ÿ {str ƒ` ° d ONLN d– Ü‹? ) )eam into speech using the voice and contr ª† ° d ONLN dA–?‹Ï )π)ol settings for that speech channel. The ° d ONLN dj› {È ˆ (Ê {speech is generated asynchr Ά ° d ONLN dÖ› ˆÈ ){onously G‡ ° d ONLN då›È} )#. This means that contr † ° d ONLN d£›}Èï )dol is r Ë@ ° d ONLN d™›ïÈ‹ )eturned to your ° d ONLN d∫Í {ˆ Δ (Û {application befor ñÄ ° d ONLN dÀÍ Δˆ )Ke the speech has fi l† ° d ONLN dfi͈C )P
nished (pr µ ° d ONLN dËÍCˆí )-obably even befor õ‡ ° d ONLN d˘ÍíˆÍ )Oe it has begun). The ° d ONLN d˜ { ˆ ( {maximum length of text buf /¿ ° d ONLN d(˜ ˜ )|=fer that can be spoken is limited only by the available RAM. ° d ONLN de { § ( {However † ° d ONLN dl §I ))), it’s generally not very friendly to for † ° d ONLN dïIÊ )•&ce the user to listen to long uninterr ¿Ä ° d ONLN dªÊ )ùupted ° d ONLN d¡ { ÷ ( {text unless the user r û@ ° d ONLN d◊ ÷ )[ equests it. . ° d ONLN d‰# {/ Ö (, {If ° d ONLN dÁ# Ö/ ª )
° d ONLN d < I F Q ( D Is ° d ONLN d > ] F f )W úÄ ° d ONLN d > f F ë ) ARNING
ˇ·ˇ‚ˆA
. ° d ONLN d H ] T h ( Q ]W Û` ° d ONLN d
H g T x )
ith ,
Courier Û` ° d ONLN d H x T Æ ) SpeakText Û` ° d ONLN d H Æ T Î )6, unlike with Û` ° d ONLN d % H Î T- )= SpeakString Û` ° d ONLN d 0 H- Tf )B, the text buf ≈¿ ° d ONLN d > Hf Tò )9 fer must be . ° d ONLN d J T ] `N ( ] ]3locked in memory and must not move during the entir ∂ ° d ONLN d } TN `ë )Òe time that it is ° d ONLN d è ` ] l ( i ]%being converted into speech. This buf ≠† ° d ONLN d ¥ ` l )•fer is r ® ° d ONLN d º ` lS ) ead at interr f‡ ° d ONLN d … `T lí )6upt time, and ° d ONLN d ◊ l ] x ≤ ( u ]very undesirable ef q ° d ONLN d Í l ≤ xV )U'fects will happen if it moves or is pur ∏ ° d ONLN d lV xp )§ged fr ≈` ° d ONLN d lp xÄ )om ° d ONLN d x ] Ñ Ç ( Å ]memory Õ ° d ONLN d x Å Ñ É )$. M ° d ONLN d" { â É ê )s ° d ONLN d$ ù ¶ 5 ( § RESUL ëÄ ° d ONLN d) ù 5 ¶ Y )T CODES
Ò ˙È 4 Ú ˘È Û ÛÔ
ˇ·ˇ‚ˆA ° d ONLN d} ‰ Ú [ ( Ó
StopSpeech ˇˇˇˇˇˇ ( Ó„1
. ° d ONLN dâ ] q ( ]The ° d ONLN dç q ≠ )
StopSpeech ° d ONLN dó ≠ ≥ )< r R` ° d ONLN dô ≥Å )-outine terminates speech delivery on a specifi R` ° d ONLN d«Åµ )Œ ed channel. ° d ONLN d” ]( ´ (% ]pascal OSErr ° d ONLN d‡ ´(k )N StopSpeech (SpeechChannel chan);
StopSpeech ˇˇI ° d ONLN d\u ÙÅs )< , the application can safely r @ ° d ONLN dzusŃ )elease any text buf Ì¥ ° d ONLN dçuƒÅË )Q fer that ° d ONLN dñÇ ]é7 (ã ]0that the speech synthesizer has been using. The ° d ONLN dΔÇ7és )⁄
c channel ˇ˛“‚ ° d ONLN dfl∂ ]¬ ´ (ø ]is still speaking.) ˇ¸x¶ ¯¶ ° d ONLN dÛ∂ ´¬ Á )N
StopSpeech ˇ˛“‚ ¯¶ ° d ONLN d˝∂ Á¬G )< can be called for an alr ºR ° d ONLN d∂H¬‘ )a eady idle channel without ill ef ≠ ° d ONLN d6∂‘¬Ë )åfect. . ° d ONLN d=› Ê 5 (‰ RESUL ëÄ ° d ONLN dB› 5Ê Y )T CODES
° d ONLN d≥% ]1 ≈ (. ]The Speech Manager pr +† ° d ONLN d»% Δ1– )i=ovides several methods of adjusting the variables that can af A¿ ° d ONLN d%–1‚ (.–fect ° d ONLN d
2 ]> Ê (; ] the way speech is synthesized. § ° d ONLN d)2 Ê>m )â Although most applications pr HÄ ° d ONLN dF2n>‚ )àobably do not need to use ° d ONLN d`? ]K æ (H ]these advanced featur y ° d ONLN du? æKfl )aCes, two of the speech variables, speaking rate and speaking pitch, ° d ONLN d∏L ]X e (U ]ar E ° d ONLN d∫L fX∞ ) Je useful enough that a very simple way of adjusting these parameters on a ° d ONLN dY ]e ‚ (b ] channel-by-channel basis is pr ¡¿ ° d ONLN d"Y ‚e8 )Öovided. Routines ar 9` ° d ONLN d5Y9efi )W&e supplied that enable an application ° d ONLN d[f ]r* (o ]-to both set and get these parameters. However X† ° d ONLN dàf*rk )Õ, the audible ef j¿ ° d ONLN dòfkr‹ )Afects of changing the rate ° d ONLN d≥s ] ” (| ]and pitch of speech vary fr y‡ ° d ONLN dŒs ”œ )v:om synthesizer to synthesizer; you should test the actual ° d ONLN dÄ ]å ` (â ]r E ° d ONLN d Ä aåÅ )@esults on all synthesizers with which your application may work. . ° d ONLN d0 ´ ] ∑ { ( ¥ ]noErr . ° d ONLN d6 ´ ˆ ∑ ˚ )ô0 ° d ONLN d8 ´ ∑+ )No err E† ° d ONLN d> ´, ∑5 ) or . ° d ONLN dB ∂ ] ¬ … ( ø ]invalidComponentID . ° d ONLN dU ∂ ‚ ¬ ˚ )Ö–3000 . ° d ONLN d[ ∂ ¬4 )-Invalid ° d ONLN dc ∂4 ¬Ç )%SpeechChannel ° d ONLN dp ∂Ç ¬¥ )N
parameter ° d ONLN dIÍ ]ˆ { (Û ]noErr . ° d ONLN dOÍ ˚ˆ )û0 ° d ONLN dQ͈0 )No err E† ° d ONLN dWÍ1ˆ: ) or . ° d ONLN d[ı ] … (˛ ]invalidComponentID . ° d ONLN dnı Á )ä–3000 . ° d ONLN dtı9 )-Invalid ° d ONLN d|ı9á )%SpeechChannel ° d ONLN dâıáπ )N
° d ONLN d ; { G « ( D {Speaking rates ar d ° d ONLN d ; « G Í )Le specifi ‡ ° d ONLN d ; Î G< )$ed in terms of wor %Ä ° d ONLN d , ;< G )Q(ds per minute (WPM). While this unit of ° d ONLN d T H { T õ ( Q {measur &¿ ° d ONLN d Z H ú T œ )! ement is dif ÒÄ ° d ONLN d f H œ T ’ )3fi ˛@ ° d ONLN d h H ’ T ) cult to defi J` ° d ONLN d t H T: )0 ne in any pr F¿ ° d ONLN d Ä H: Td )5 ecise way ∫ ° d ONLN d â Hc T˝ ))%, it is generally easy to understand ° d ONLN d Æ U { aI ( ^ {/and use. The range of supported rates is not pr ¶` ° d ONLN d › UI a^ )Œedefi b ° d ONLN d ‚ U_ aŸ )ned by the Speech Manager ¯` ° d ONLN d ˚ Uÿ aÙ )y. Each ° d ONLN d b { n ⁄ ( k {speech synthesizer pr ∑† ° d ONLN d b ⁄ nª )_2ovides its own range of speaking rates. Furthermor M† ° d ONLN dI bº nı )‚e, any specifi e‡ ° d ONLN dW bı n˚ )9c ° d ONLN dY o { { Œ ( x {rate value will corr Ä ° d ONLN dm o œ {- )Tespond to slightly dif @ ° d ONLN dÉ o- {9 )^fer „¿ ° d ONLN dÜ o8 {É ) ent rates with dif ˙@ ° d ONLN dò oÉ {è )Kfer ‹¿ ° d ONLN dõ oè {⁄ ) ent synthesizers. ° d ONLN dÆ Å { ç — ( ä {Speaking pitches ar ù† ° d ONLN d¡ Å — ç È )Ve defi Ÿ` ° d ONLN d« Å È çs ) ned on a musical scale that corr LJ ° d ONLN dÁ Åt ç‚ )ãesponds to the keys on a ° d ONLN d é { ö ú ( ó {standar ±Ä ° d ONLN d é ú ö ‰ )!d piano keyboar ®† ° d ONLN d é ‰ ö^ )H d. By convention, pitches ar ` ° d ONLN d2 é_ öj ){e r " ° d ONLN d5 éj öx ) epr ≤¿ ° d ONLN d8 éx öÆ ) esented as fi ≈‡ ° d ONLN dE éÆ ö )6xed-point values in ° d ONLN dY õ { ß Æ ( § { the range fr ì ° d ONLN de õ Æ ß ‰ )3 om 0.000 thr 5@ ° d ONLN dq õ  ß: )7ough 100.000, wher …` ° d ONLN dÉ õ: ßq )Ue 60.000 corr ∞` ° d ONLN dê õq ßı )7 esponds to middle C (261.625 ° d ONLN d≠ ® { ¥( ( ± {'Hz) on a conventional piano. Pitches ar ±Ä ° d ONLN d‘ ®( ¥3 )≠e r ¿ ° d ONLN d◊ ®3 ¥A ) epr P‡ ° d ONLN d⁄ ®B ¥Ó )(esented on a logarithmic scale. On this ° d ONLN d µ { ¡ ( æ {!scale, a change of +12 units corr Å@ ° d ONLN d# µ ¡{ )åesponds to doubling the fr ) ° d ONLN d= µ| ¡° )uequency Ä ° d ONLN dD µ† ¡ )$, while a change of –12 ° d ONLN d\ ¬ { Œ • ( À {
units corr ›† ° d ONLN df ¬ • Œ )*esponds to halving the fr › ° d ONLN d ¬ Œ8 )nequency ≈Ä ° d ONLN dÜ ¬7 Œ˝ )$0. For a further discussion of pitch values, see ° d ONLN d∂ œ { € € ( ÿ {“Getting Information ãÄ ° d ONLN dÀ œ € €O )`About a Speech Channel,” Ì@ ° d ONLN d„ œO €µ )t later in this document. ° d ONLN d¸ · { Ì Å ( Í {T ∫¿ ° d ONLN d˝ · Ä Ì æ )ypical voice fr „‡ ° d ONLN d · æ Ì+ )>equencies might range fr \‡ ° d ONLN d$ ·, ÌE )nom ar Î` ° d ONLN d) ·E ÌÌ )%ound 90 Hertz for a low-pitched male ° d ONLN dN Ó { ˙ Æ ( ˜ { voice to per † ° d ONLN dZ Ó Ø ˙• )49haps 300 Hertz for a high-pitched child’s voice. These fr 0¿ ° d ONLN dì Ó• ˙“ )ˆ
equencies ° d ONLN dù ˚ { å ( {corr ` ° d ONLN d° ˚ çT ).espond to pitch values of 41.526 and 53.526, r G ° d ONLN dœ ˚TÖ )« espectively ° d ONLN d⁄ ˚ÑÜ )0. ° d ONLN d‹ { ( {#Changes in speech rate and pitch ar ºÄ ° d ONLN dˇ' )ùe ef ˆ ° d ONLN d'¯ )0fective immediately (as soon as the synthesizer ° d ONLN d3 {& ê (# {can r † ° d ONLN d8 ë&m )2espond), even if they occur in the middle of a wor · ° d ONLN djl&t )€d.
V 9_ 4W 9^ X 9X
ˇ·ˇ‚ˆA ° d ONLN dmI 9W ä (S 9SetSpeechRate ˇˇˇˇˇˇ (S1
. ° d ONLN d|h {t è (q {The ,
Courier ° d ONLN dÄh èt › )SetSpeechRate ° d ONLN dçh ›t „ )N r R` ° d ONLN dèh „tˆ )=outine sets the speaking rate on a designated speech channel. ° d ONLN dÕÅ {ç … (ä {pascal OSErr ° d ONLN d⁄Å …ç„ )N/SetSpeechRate (SpeechChannel chan, Fixed rate);
. ° d ONLN d ß {≥ ì *chan . ° d ONLN d"ß ◊≥ Ù )\Specifi ‡ ° d ONLN d)ß Ù≥> ) c speech channel . ° d ONLN d:∂ {¬ ì (ø {rate . ° d ONLN d?∂ ◊¬ · )\W ï ° d ONLN d@∂ ‡¬ È ) or œÄ ° d ONLN dB∂ ȬM ) d output speaking rate ° d ONLN dY‹ 9 r („ 9 DESCRIPTION
. ° d ONLN deÍ {ˆ è +BThe ° d ONLN diÍ èˆ › )SetSpeechRate ° d ONLN dvÍ ›ˆ „ )N r R` ° d ONLN dxÍ „ˆ˘ )@outine is used to adjust the speaking rate on a speech channel. ° d ONLN d∏˜ { è ( {The ° d ONLN dº˜ è ß )rate ° d ONLN d¿˜ ß ) parameter is specifi ° d ONLN d’˜+ )\ ed as a fi ° d ONLN dfl˜+m )(xed-point, wor R` ° d ONLN d̘m )Bds per minute value. Ù ° d ONLN d˜… )\As a general . ° d ONLN d { ~ ( {r ^† ° d ONLN d N ).ule of thumb, “normal” speaking rates range fr üÄ ° d ONLN d>Ng )œom ar . ° d ONLN dCh√ )ound 150 WPM to ar ìÄ ° d ONLN dU√Ó )[ ound 180 ° d ONLN d^ { † ( {>WPM. It is important when working with speaking rates, however òÄ ° d ONLN dú† (†, to keep in mind that ° d ONLN d≥ {* ¥ (' {users will dif ˜‡ ° d ONLN d¡ ¥* à )9fer gr ‹ ° d ONLN d« Ã*˝ )Heatly in their ability to understand synthesized speech at a particular ° d ONLN d+ {7‚ (4 {Vrate based upon their level of experience listening to the voice and their ability to ° d ONLN de8 {Dd *6anticipate the types of utterances they will encounter ã` ° d ONLN dõ8dDf )È. ° d ONLN dù_ 9h S (f 9RESUL ëÄ ° d ONLN d¢_ Sh w )T CODES
ˇ·ˇ‚ˆA ° d ONLN d ; I n ( E GetSpeechRate ˇˇˇˇˇˇ ( E„1
. ° d ONLN d Z ] f q ( c ]The ,
Courier ° d ONLN d Z q f ø )GetSpeechRate ° d ONLN d Z ø f ≈ )N r R` ° d ONLN d " Z ≈ f Á )outine r $¿ ° d ONLN d * Z Á f] )"eturns the speech rate curr ˜ ° d ONLN d E Z\ f› )u ently active on a designated . ° d ONLN d b g ] s ¢ ( p ]speech channel. . ° d ONLN d r Ä ] å ´ *pascal OSErr ° d ONLN d Ä ´ åÀ )N0GetSpeechRate (SpeechChannel chan, Fixed *rate);
. ° d ONLN d √ ¶ ] ≤ u *chan . ° d ONLN d » ¶ π ≤ ÷ )\Specifi ‡ ° d ONLN d œ ¶ ÷ ≤ ) c speech channel . ° d ONLN d ‡ µ ] ¡ { ( æ ]*rate . ° d ONLN d Ê µ π ¡ )\Pointer to the curr ˚¿ ° d ONLN d ˘ µ ¡T )Pent speaking rate ° d ONLN d € ‰ T ( ‚ DESCRIPTION
. ° d ONLN d Ë ] Ù q +BThe ° d ONLN d Ë q Ù ø )GetSpeechRate ° d ONLN d( Ë ø Ù ≈ )N r R` ° d ONLN d* Ë ≈ Ù )outine is used to fi R` ° d ONLN d> Ë Ùï )P nd out the speaking rate curr $¿ ° d ONLN d[ Ëï Ù‚ )Äently active on a . ° d ONLN dm ı ] ¢ ( ˛ ]speech channel. ° d ONLN d} % 5 (# RESUL ëÄ ° d ONLN dÇ 5% Y )T CODES
p xÈ 4p xÈ r rÔ
ˇ·ˇ‚ˆA ° d ONLN d÷b p o (l SetSpeechPitch ˇˇˇˇˇˇ (l„1
. ° d ONLN dÊÇ ]é q (ã ]The ° d ONLN dÍÇ qé ≈ )SetSpeechPitch ° d ONLN d¯Ç ≈é À )T r R` ° d ONLN d˙Ç Àé‰ )>outine sets the speaking pitch on a designated speech channel. ° d ONLN d9õ ]ß ´ (§ ]pascal OSErr ° d ONLN dFõ ´ß— )N1SetSpeechPitch (SpeechChannel chan, Fixed pitch);
. ° d ONLN dã¡ ]Õ u *chan . ° d ONLN dê¡ πÕ ÷ )\Specifi ‡ ° d ONLN dó¡ ÷Õ ) c speech channel . ° d ONLN d®– ]‹ { (Ÿ ]pitch . ° d ONLN dÆ– π‹ ¬ )\Fr ‘ ° d ONLN d∞– ¬‹ ) equency of voice ° d ONLN d¡ı ˛ T (¸ DESCRIPTION
. ° d ONLN dÕ ] Ç +BUse the ° d ONLN d’ Ç ÷ )%SetSpeechPitch ° d ONLN d„ ÷ ‹ )T r R` ° d ONLN d ‹J )outine to change the curr $¿ ° d ONLN d˛J’ )n ent speaking pitch on a speech . ° d ONLN d ] Ç ( ]channel. ° d ONLN d&6 ? 5 (= RESUL ëÄ ° d ONLN d+6 5? Y )T CODES
. ° d ONLN dâ) ]5 { (2 ]noErr . ° d ONLN dè) ˜5 ¸ )ö0 ° d ONLN dë)5, )No err E† ° d ONLN dó)-56 ) or . ° d ONLN dõ4 ]@ … (= ]invalidComponentID . ° d ONLN dÆ4 „@ ¸ )Ü–3000 . ° d ONLN d¥4@5 )-Invalid ° d ONLN dº45@É )%SpeechChannel ° d ONLN d…4É@µ )N
parameter ° d ONLN d2D ]P { (M ]noErr . ° d ONLN d8D ˙P ˇ )ù0 ° d ONLN d:DP/ )No err E† ° d ONLN d@D0P9 ) or . ° d ONLN dDO ][ … (X ]invalidComponentID . ° d ONLN dWO Ê[ ˇ )â–3000 . ° d ONLN d]O[8 )-Invalid ° d ONLN deO8[Ü )%SpeechChannel ° d ONLN drOÜ[∏ )N
ˇ·ˇ‚ˆA ° d ONLN d ; 9 I ê ( E 9GetSpeechPitch ˇˇˇˇˇˇ ( E1
. ° d ONLN d Z { f è ( c {The ,
Courier ° d ONLN d Z è f „ )GetSpeechPitch ° d ONLN d " Z „ f È )T r R` ° d ONLN d $ Z È f )outine r $¿ ° d ONLN d , Z fK )"eturns the curr ˜ ° d ONLN d ; ZJ fË )?#ent speaking pitch on a designated . ° d ONLN d ^ g { s ¿ ( p {speech channel. . ° d ONLN d n Ä { å … *pascal OSErr ° d ONLN d { Ä … åı )N2GetSpeechPitch (SpeechChannel chan, Fixed *pitch);
. ° d ONLN d ¡ ¶ { ≤ ì *chan . ° d ONLN d Δ ¶ ◊ ≤ Ù )\Specifi ‡ ° d ONLN d Õ ¶ Ù ≤> ) c speech channel . ° d ONLN d fi µ { ¡ ô ( æ {pitch . ° d ONLN d ‰ µ ◊ ¡ ‡ )\Fr ‘ ° d ONLN d Ê µ ‡ ¡* ) equency of voice ° d ONLN d ˜ € 9 ‰ r ( ‚ 9 DESCRIPTION
. ° d ONLN d Ë { Ù è +BThe ° d ONLN d Ë è Ù „ )GetSpeechPitch ° d ONLN d Ë „ Ù È )T r R` ° d ONLN d Ë È Ù9 )outine is used to fi R` ° d ONLN d+ Ë9 Ùø )P nd out the speaking pitch curr $¿ ° d ONLN dI Ëø Ù )Üently active on . ° d ONLN dY ı { » ( ˛ {a speech channel. ° d ONLN dk 9% S (# 9RESUL ëÄ ° d ONLN dp S% w )T CODES
^ 9e 4^ 9d _ {_
ˇ·ˇ‚ˆA ° d ONLN dƒP {^ ≠ +(7 Putting It Ü@ ° d ONLN dœP ≠^ Ω )2All ˘Ä ° d ONLN d”P Ω^ ƒ )T ˘Ä ° d ONLN d‘P √^ Î )ogether ˇˇˇˇˇˇ ‘@ (Z 1
° d ONLN d›d {p € (m {The code fragment in G† ° d ONLN dÚd ‹p
ˇ·ˇ‚ˆA ° d ONLN d◊ {‚ ß (fl { Listing 1-4 ° d ONLN d◊ ø‚ )DPutting it all together
. ° d ONLN d)Ò {˝ ô (˙ {OSErr ° d ONLN d4Ò Á˝ ˇ )lerr; ° d ONLN d9ˇ { ü ( {Str255 ° d ONLN dEˇ Á π )l#myStr = "\pThe bat sat on my hat."; ° d ONLN di { ± ( { VoiceSpec ° d ONLN dx Á )lvoice; ° d ONLN d {' € ($ {VoiceDescription ° d ONLN dí €' · )` ° d ONLN dñ Á' ˘ ) vd; ° d ONLN dö) {5 • (2 {Boolean ° d ONLN dß) Á5M )lgotVoice = FALSE; ° d ONLN dπ7 {C ô (@ {short ° d ONLN dƒ7 ÁCk )lvoiceCount, gender, i; ° d ONLN d€E {Q … (N {SpeechChannel ° d ONLN dÓE ÁQ )lchan; ° d ONLN dÙS {_ ô (\ {Fixed ° d ONLN dˇS Á__ )lorigPitch, newPitch; ° d ONLN do {{S (x {$if (myStr[0] && SpeechAvailable()) { ° d ONLN d;} çâG + err = CountVoices(&voiceCount); ° d ONLN dd}Gâ˚ )∫ // count the available voices ° d ONLN dÑã çó ± (î çi = 1; ° d ONLN dw) {5 ô (2 {noErr . ° d ONLN d}) 5! )°0 ° d ONLN d)55Q )No err E† ° d ONLN dÖ)R5[ ) or . ° d ONLN dâ4 {@ Á (= {invalidComponentID . ° d ONLN dú4@! )ç–3000 . ° d ONLN d¢45@Z )-Invalid ° d ONLN d™4Z@® )%SpeechChannel ° d ONLN d∑4®@⁄ )N
’ Å ·e +&err = NewSpeechChannel(&voice, &chan); ° d ONLN d3 „ Å Ô Û *if (err == noErr) { ° d ONLN dJ Ò ì ˝— +5err = GetSpeechPitch(chan, &origPitch); // cur pitch ° d ONLN dÉ ˇ ì ˘ *if (err == noErr) ° d ONLN dô •ß ++err = SpeakText(chan, &myStr[1], myStr[0]); ° d ONLN dÃ) ì5 ∑ (2 ìi = 0; ° d ONLN d÷7 ìC ˘ *if (err == noErr) ° d ONLN dÏE •QA +while (SpeechBusy() > 0) { ° d ONLN d S ∑_A +CoolAnimationRoutine(); ° d ONLN d)a ∑m◊ *0newPitch = (i - 4) << 16; // fixed pitch offset ° d ONLN d_o ∑{; *newPitch += origPitch; ° d ONLN d{} ∑â *i = (i + 1) & 7; ° d ONLN då}â◊ )` // steps from 0 to 7 repeatedly ° d ONLN d≤ã ∑óï (î ∑%err = SetSpeechPitch(chan, newPitch); ° d ONLN d›ô ∑•} *!if ((err != noErr) || Button()) { ° d ONLN dß …≥S +err = StopSpeech(chan); ° d ONLN d#µ …¡ Ì *break; ° d ONLN d/√ ∑œ Ω (à ∑} ° d ONLN d5— •› ´ (⁄ •} ° d ONLN d:fl ìÎY (Ë ì!err = DisposeSpeechChannel(chan); ° d ONLN d^Ì Å˘ á (ˆ Å} ° d ONLN da˚ o u ( o} ° d ONLN dd o ’ *if (err != noErr) ° d ONLN dx Å## +NotSoCoolAlertRoutine(err);
I PÈ 4J PÈ K ]KÈ
ˇ·ˇ‚ˆA ˇˇ‹. . ˇ◊ ° d ONLN dî: ]I ” (E ]Advanced Routines ˇˇˇˇˇˇ €r (E·1
° d ONLN dßP ]\' (Y ].This section describes several advanced or rar ÷ ° d ONLN d’P'\û ) ely-used Speech Manager r Ç` ° d ONLN dÓPü\ƒ )x outines. ‘ ° d ONLN d˜Pƒ\ )%Y î† ° d ONLN d¯P \◊ )ou ° d ONLN d˚] ]i ∫ (f ]can use them to impr º ° d ONLN d] ∫i} )]-ove the quality of your application’s speech. ˇ‘ ◊# ˇ ˇˇˇˇ # ◊
ˇ·ˇ‚ˆA ° d ONLN d ; { I ( E {Advanced Speech Controls ˇˇˇˇˇˇ ‘@ ( E 1
. ° d ONLN d O { [ è ( X {The ,
Courier ° d ONLN d O è [ À )
StopSpeech ° d ONLN d ( O À [ — )< r R` ° d ONLN d * O — [* )outine, described in R` ° d ONLN d ? O* [æ )Y “Starting and Stopping Speech,” R` ° d ONLN d ^ Oæ [ )î earlier in this . ° d ONLN d o \ { h ∂ ( e { document, pr ° d ONLN d { \ ∑ h7 )< ovides a simple way to interr ä ° d ONLN d ò \7 h√ )Ä upt any speech output instantly ˝Ä ° d ONLN d ∑ \¬ hÏ )ã
. In some ° d ONLN d ¡ i { u ƒ ( r {situations it is pr 4¿ ° d ONLN d ‘ i ≈ ub )J%eferable to be able to stop speech pr î‡ ° d ONLN d ˘ ib ufl )ù oduction at the next natural . ° d ONLN d v { Ç • ( {boundary d@ ° d ONLN d v § Ç )), such as the next wor 6† ° d ONLN d4 v Çh )_d or the end of the curr ° d ONLN dL vh Ç¢ )eent sentence. ° d ONLN dZ v¢ ÇÍ ): StopSpeechAt ° d ONLN df vÍ ÇÏ )H . ° d ONLN dg É { è Ñ ( å {pr G ° d ONLN di É Ö è ‰ )
ˇ·ˇ‚ˆA ° d ONLN dÂ) 97 Ü (3 9 StopSpeechAt ˇˇˇˇˇˇ (31
. ° d ONLN dÛH {T è (Q {The ° d ONLN d˜H èT ◊ ) StopSpeechAt ° d ONLN dH ◊T › )H r R` ° d ONLN dH ›Ti ) outine halts speech at a specifi R` ° d ONLN d%HiTˆ )å!c point in the text being spoken. ° d ONLN dGa {m … (j {pascal OSErr ° d ONLN dTa …m )N4StopSpeechAt (SpeechChannel chan, long whereToStop); ° d ONLN dây {Ö ü (Ç {enum { ° d ONLN dëá çì … +
kImmediate ° d ONLN d°á ˘ì )l= 0, ° d ONLN dßï ç° … (û ç
kEndOfWord ° d ONLN d∑ï ˘° )l= 1, ° d ONLN dΩ£ çØ · (¨ çkEndOfSentence ° d ONLN d—£ ˘Ø )l= 2 ° d ONLN d’± {Ω á (∫ {};
À 9⁄ 4À 9Ÿ . ° d ONLN dÿ {’ « *Field descriptions
ˇ·ˇ‚ˆA
. ° d ONLN dÎ◊ {„ ì *chan . ° d ONLN d◊ ◊„ Ù )\Specifi ‡ ° d ONLN d˜◊ Ù„> ) c speech channel . ° d ONLN dÊ {Ú Ω (Ô { whereToStop . ° d ONLN dÊ ◊Úë )\,Location in text at which speech is to stop ° d ONLN dA 9 r ( 9 DESCRIPTION
kImmediate ° d ONLN dˇ9 ◊Eï )<) constant stops speech output immediately d@ ° d ONLN d(9îEô )Ω. . ° d ONLN d+N {U Ä (T {n
. ° d ONLN d-K áW õ ) The ° d ONLN d1K õW ◊ )
kEndOfWord ° d ONLN d;K ◊Wñ )<- constant lets speech continue until the curr R` ° d ONLN dhKñW∑ )øent wor $¿ ° d ONLN doK∑WË )! d has been . ° d ONLN dzW ác ´ (` áspoken. ° d ONLN dÉl {s Ä (r {n
. ° d ONLN dÖi áu õ ) The ° d ONLN dâi õu Ô )kEndOfSentence ° d ONLN dói Ôu› )T8 constant lets speech continue until the end of the curr R` ° d ONLN dœi›uÌ )Óent . ° d ONLN d”u áÅ ‹ (~ ásentence has been r Ƈ ° d ONLN dÊu ‹Å ˇ )Ueached. ˇË ◊# ˇ ˇˇˇˇ # ◊
° d ONLN d ; ] G v ( D ]This r ‹Ä ° d ONLN d ; v G ò )outine r c‡ ° d ONLN d ; ô G Ô )#eturns immediately Ω‡ ° d ONLN d ; Ó Gœ )U3, although speech output continues until the specifi ≠‡ ° d ONLN d T ;– G› )‚ed ° d ONLN d W H ] T £ ( Q ]point has been r 3` ° d ONLN d g H § T ≈ )Geached.
b pÈ 4 c pÈ , Zapf Dingbats ° d ONLN d o b I l Q ( j Is ° d ONLN d p c ] k f ( i ]W úÄ ° d ONLN d q c f k ë ) ARNING
ˇ·ˇ‚ˆA
° d ONLN d x n ] z c ( w ]Y @Ä ° d ONLN d y n c z û )ou must not r ‡ ° d ONLN d Ü n û z\ );*elease the memory associated with the curr }¿ ° d ONLN d ∞ n] zè )ø ent text buf á ° d ONLN d º nè zù )2fer ° d ONLN d ¿ z ] Üí ( É ]Huntil the channel status indicates that the speech channel output is no ° d ONLN d Ü ] í ë * longer busy π¿ ° d ONLN d Ü ê í í )3. 9¿ ° d ONLN d â ò ë ü )s
° d ONLN d ó ] £ · ( † ] If the end of the input text buf † ° d ONLN d7 ó ‚ £ ˛ )Öfer is r ° d ONLN d? ó ˛ £6 ) eached befor i` ° d ONLN dK ó6 £j )8 e the specifi ~Ä ° d ONLN dX ój £Õ )4ed stopping point, the ° d ONLN do § ] ∞Ø ( ≠ ]Nspeech synthesizer will stop at this point. Once the stopping point has been r ¿ ° d ONLN dΩ §∞ ∞‰ ( ≠∞ eached, the ˇˇE⁄ . ° d ONLN d… ± ] Ω • ( ∫ ]application is fr fi ° d ONLN d⁄ ± • Ω æ )Hee to r <( ° d ONLN d· ± ø Ω )elease the text buf ‡ ° d ONLN dÙ ± Ω )Pfer "∂ ° d ONLN d˜ ± ΩD )
. Calling ,
Courier ˇ˝—é Æj ° d ONLN d ±D Ωå )( StopSpeechAt ˇˇE⁄ Æj ° d ONLN d ±å Ω• )H with ˇ˝—é : ° d ONLN d ±¶ ΩË ) whereToStop ˇˇE⁄ : ° d ONLN d ±Ë ΩÈ )B ° d ONLN d æ ] É ( « ] equal to ° d ONLN d( æ É ø )&
kImmediate ° d ONLN d2 æ ø + )< is equivalent to calling ° d ONLN dL æ+ g )l
StopSpeech ° d ONLN dV æg • )<, described on ° d ONLN de æ• Ω )>page ° d ONLN dj æΩ « )14 ° d ONLN dl æ« Ã )
. ° d ONLN do – ] ‹ ò ( Ÿ ]Contrast the ° d ONLN d| – ò ‹ ‡ ); StopSpeechAt ° d ONLN dà – ‡ ‹ Ê )H r R` ° d ONLN dä – Ê ‹ ) outine with R` ° d ONLN dñ – ‹_ )7 PauseSpeech R` ° d ONLN d° –_ ‹ß )B, described next. . ° d ONLN d≥ ˆ ˇ 5 ( ˝ RESUL ëÄ ° d ONLN d∏ ˆ 5 ˇ Y )T CODES
J SÈ 4K RÈ L LÔ
ˇ·ˇ‚ˆA ° d ONLN d = K o (G PauseSpeechAt ˇˇˇˇˇˇ (G„1
. ° d ONLN d\ ]h q (e ]The ° d ONLN d \ qh ø )PauseSpeechAt ° d ONLN d,\ øh ≈ )N r R` ° d ONLN d.\ ≈h{ ))outine causes speech to pause at a specifi R` ° d ONLN dX\{h” )∂ed point in the text . ° d ONLN dmi ]u ö (r ]being spoken. . ° d ONLN d{Ç ]é ´ *pascal OSErr ° d ONLN dàÇ ´é} )N#PauseSpeechAt (SpeechChannel chan, ° d ONLN dÆê Åú Û (ô Ålong whereToPause); ° d ONLN d¬® ]¥ Å (± ]enum { ° d ONLN d ∂ o¬ ´ +
kImmediate ° d ONLN d⁄∂ €¬ Û )l= 0, ° d ONLN d‡ƒ o– ´ (Õ o
kEndOfWord ° d ONLN dƒ €– Û )l= 1, ° d ONLN dˆ“ ofi √ (€ okEndOfSentence ° d ONLN d
. ° d ONLN d$ ] u *chan . ° d ONLN d) π ÷ )\Specifi ‡ ° d ONLN d0 ÷ ) c speech channel . ° d ONLN dA ]! • ( ] whereToPause . ° d ONLN dN π!z )\-Location in text at which speech is to pause ° d ONLN d|; D T (B DESCRIPTION
. ° d ONLN dàH ]T ü +B PauseSpeech ° d ONLN dìH üT Î )B makes speech pr R` ° d ONLN d£H ÎT^ )Loduction pause at a specif "‡ ° d ONLN dΩH^T— )sied point in the text. The ° d ONLN dÿU ]a • (^ ] whereToPause ° d ONLN d‰U •aÖ )H4 parameter should be set to one of these constants: . ° d ONLN dk ]r b (q ]n
. ° d ONLN dh it } ) The ° d ONLN d h }t π )
kImmediate ° d ONLN d)h πtw )<) constant stops speech output immediately d@ ° d ONLN dRhvt{ )Ω. . ° d ONLN dU} ]Ñ b (É ]n
. ° d ONLN dWz iÜ } ) The ° d ONLN d[z }Ü π )
kEndOfWord ° d ONLN dez πÜx )<- constant lets speech continue until the curr R` ° d ONLN dízxÜô )øent wor $¿ ° d ONLN dôzôÜ )! d has been . ° d ONLN d§Ü ií ç (è ispoken. . ° d ONLN dø ] { ( ]noErr . ° d ONLN d≈ ˘ ˛ )ú0 ° d ONLN d«. )No err E† ° d ONLN dÕ/8 ) or . ° d ONLN d— ] … ( ]invalidComponentID . ° d ONLN d‰  ˛ )à–3000 . ° d ONLN dÍ7 )-Invalid ° d ONLN dÚ7Ö )%SpeechChannel ° d ONLN dˇÖ∑ )N
Courier ° d ONLN d ; õ G Ô )kEndOfSentence ° d ONLN d ; Ô G› )T8 constant lets speech continue until the end of the curr R` ° d ONLN d J ;› GÌ )Óent . ° d ONLN d N G á S ‹ ( P ásentence has been r Ƈ ° d ONLN d a G ‹ S ˇ )Ueached. ° d ONLN d j X { d ƒ ( a {When the specifi 7‡ ° d ONLN d z X ≈ d ˘ )Jed point is r ˚` ° d ONLN d á X ˘ d‡ )45eached, the speech channel enters the paused state, r £¿ ° d ONLN d º X· dÎ )Ëefl z ° d ONLN d ø XÏ d ) ected . ° d ONLN d ≈ e { q  ( n {in the channel’s status. ° d ONLN d fi e  q3 )jPauseSpeechAt ° d ONLN d Î e3 q9 )N r R` ° d ONLN d Ì e9 qí )eturns immediately 6† ° d ONLN d ˇ eë q )X, although speech output . ° d ONLN d r { ~ ˚ ( { { will continue until the specifi K@ ° d ONLN d7 r ¸ ~# )Å ed point. ° d ONLN dA Ñ { ê ˇ ( ç { If the end of the input text buf † ° d ONLN da Ñ ê )Öfer is r ° d ONLN di Ñ êT ) eached befor i` ° d ONLN du ÑT êà )8 e the specifi ~Ä ° d ONLN dÇ Ñà êÓ )4ed pause point, speech ° d ONLN dô ë { ù ( ö {#output pauses at the end of the buf â¿ ° d ONLN dº ë ù! )öfer ‹Ä ° d ONLN dø ë ù" ) . . ° d ONLN d¡ £ { Ø … ( ¨ {PauseSpeechAt ° d ONLN dŒ £ … Ø Ÿ )N dif R` ° d ONLN d“ £ Ÿ Ø Ù )fers fr $¿ ° d ONLN dŸ £ Ù Ø )om $¿ ° d ONLN d‹ £ Ø? )
StopSpeech $¿ ° d ONLN dÊ £? ØT )< and $¿ ° d ONLN dÎ £T Øú ) StopSpeechAt $¿ ° d ONLN d˜ £ú Ø˘ )H in that a subsequent ° d ONLN d ∞ { º ö ( π {call to ° d ONLN d ∞ ö º Ó ) ContinueSpeech ° d ONLN d# ∞ Ó ºº )T1, described next, causes the contents of the curr R` ° d ONLN dT ∞º ºÓ )Œ ent text buf $¿ ° d ONLN d` ∞Ó º˝ )2fer . ° d ONLN dd Ω { … Ï ( Δ {to continue being spoken.
◊ 9 Â 4 ÿ 9 Â ° d ONLN d~ ◊ g · o ( fl gs ° d ONLN d ÿ { ‡ Ñ ( fi {W úÄ ° d ONLN dÄ ÿ Ñ ‡ Ø ) ARNING
ˇ·ˇ‚ˆA
° d ONLN dá „ { Ô* ( Ï {*While in a paused state, the last text buf M† ° d ONLN d± „+ ÔV )∞
fer must r }@ ° d ONLN dª „V Ô∂ )+emain available at all . ° d ONLN d“ Ô { ˚E ( ¯ {+times and must not move. While paused, the ° d ONLN d˝ ÔE ˚ì ) SpeechChannel ° d ONLN d
Ôì ˚≤ )N status ° d ONLN d ˚ { ß ( {
indicates ° d ONLN d ˚ ß „ ),
outputBusy ° d ONLN d& ˚ „ Ì )< = ° d ONLN d) ˚ Ì )
true ° d ONLN d- ˚ ) and ° d ONLN d2 ˚b ) outputPaused ° d ONLN d> ˚bl )H = ° d ONLN dA ˚lÑ )
true ° d ONLN dE ˚Ñá ). . ° d ONLN dG ˛åì )s ° d ONLN dI 9) S (' 9RESUL ëÄ ° d ONLN dN S) w )T CODES
. ° d ONLN d≤Ü {í è (è {The ° d ONLN d∂Ü èí „ )ContinueSpeech ° d ONLN dƒÜ „í È )T r R` ° d ONLN dΔÜ Èí )outine r $¿ ° d ONLN dŒÜ í⁄ )".esumes speech after it has been halted by the ° d ONLN d¸ì {ü … (ú {PauseSpeechAt ° d ONLN d ì …ü œ )N r R` ° d ONLN d ì œü Ó )outine. ° d ONLN d¨ {∏ … (µ {pascal OSErr ° d ONLN d ¨ …∏° )N$ContinueSpeech (SpeechChannel chan);
. ° d ONLN dX“ {fi ì *chan . ° d ONLN d]“ ◊fi Ù )\Specifi ‡ ° d ONLN dd“ Ùfi> ) c speech channel ° d ONLN du¯ 9 r (ˇ 9 DESCRIPTION
. ° d ONLN dÅ { à +BAt any time after ° d ONLN dì à )QPauseSpeechAt ° d ONLN d†H )N is called, ° d ONLN d¨Hú ).ContinueSpeech ° d ONLN d∫úÍ )T may be called to ˇˇŸ" ° d ONLN dà { ‘ ( {continue speaking fr § ° d ONLN d‡ ’ • )Z-om the point at which speech paused. Calling ˇˇãf Õ¥ ° d ONLN d• ˘ )–ContinueSpeech ˇˇŸ" Õ¥ ° d ONLN d˘ )T on . ° d ONLN d {+ Ë (( {a channel that is not curr ° d ONLN d9 Ë+n )m ently in a pause state has no ef 9 ° d ONLN dY o+√ )áfect; calling it befor ùÄ ° d ONLN do √+˜ )Te a pause is ° d ONLN d|, {8 É (5 {ef o‡ ° d ONLN d~, É8 Ò )fective cancels the pause. ° d ONLN dôS 9\ S (Z 9RESUL ëÄ ° d ONLN dûS S\ w )T CODES
. ° d ONLN dU. {: ô (7 {noErr . ° d ONLN d[.: )ú0 ° d ONLN d].0:L )No err E† ° d ONLN dc.M:V ) or . ° d ONLN dg9 {E Á (B {invalidComponentID . ° d ONLN dz9E )à–3000 . ° d ONLN dÄ90EU )-Invalid ° d ONLN dà9UE£ )%SpeechChannel ° d ONLN dï9£E’ )N
parameter ° d ONLN d•` {l ô (i {noErr . ° d ONLN d´`l )ö0 ° d ONLN d≠`.lJ )No err E† ° d ONLN d≥`KlT ) or . ° d ONLN d∑k {w Á (t {invalidComponentID . ° d ONLN d kw )Ü–3000 . ° d ONLN d–k.wS )-Invalid ° d ONLN dÿkSw° )%SpeechChannel ° d ONLN dÂk°w” )N
. ° d ONLN di ] u *chan . ° d ONLN dn π ÷ )\Specifi ‡ ° d ONLN du ÷ ) c speech channel . ° d ONLN dÜ ] á ( ]textBuf . ° d ONLN dé π » )\Buf … ° d ONLN dë » Ú ) fer of text . ° d ONLN dù" ]. ô (+ ]
byteLength ° d ONLN d®" π. Ê )\
Length of ° d ONLN d≤" Ê. )-textBuf ° d ONLN d∫1 ]= • (: ] controlFlags . ° d ONLN d«1 π= “ )\Contr Â@ ° d ONLN dÃ1 “= ‚ )ol fl œ‡ ° d ONLN d—1 „= ) ags to contr ` ° d ONLN d›1=l )4ol speech behavior ° d ONLN dÒW ` T (^ DESCRIPTION
. ° d ONLN d˝d ]p ç +B When the ° d ONLN dd çp ’ )0 controlFlags ° d ONLN dd ’p7 )H parameter is set to 0, ° d ONLN d*d7py )b SpeakBuffer ° d ONLN d5dyp‰ )B behaves identically to ° d ONLN dMq ]} ì (z ] SpeakText ° d ONLN dVq ì} — )6, described on ° d ONLN deq —} È )>page ° d ONLN djq È} Û )13 ° d ONLN dlq Û} ˆ )
when the fl -Ä ° d ONLN dj™ è∂ )2 ag bit is not set), ending pr @ ° d ONLN dá™∂Ê )v3osody is applied to the speech when the end of the . ° d ONLN d∫∑ ]√ á (¿ ]textBuf ° d ONLN d¡∑ á√ Ø )*
is full. ° d ONLN d≠ı ] q (˛ ]The ° d ONLN d±ı q › )kNoSpeechInterrupt ° d ONLN d√ı › Ê )l fl ° d ONLN dΔı ÊC ) ag bit is used to contr R` ° d ONLN d›ıCó )]ol the behavior of R` ° d ONLN dıóŸ )T SpeakBuffer R` ° d ONLN d˚ıŸ€ )B . ° d ONLN d¸ ]5 ( ]2when called on a speech channel that is still busy Œ ° d ONLN d.4l )◊ . When the fl $† ° d ONLN d;m¥ )9ag bit is not set, ˇ˛Ä . ° d ONLN dN ] ü ( ] SpeakBuffer ˇˇÄ ° d ONLN dY ü )B behaves similarly to ˇ˛Ä ° d ONLN do B )a SpeakString ˇˇÄ ° d ONLN dzBV )B and ˇ˛Ä ° d ONLN dVå ) SpeakText ˇˇÄ ° d ONLN dàåÈ )6, described earlier in . ° d ONLN dü ]( ° (% ]this document. î¿ ° d ONLN dÆ °( È )DAny speech curr ˇÄ ° d ONLN dΩ È(& )Hently being pr µ† ° d ONLN dÀ '(Ö )>oduced on the specifi ∂ ° d ONLN d‡ Ö(· )^ed speech channel is ° d ONLN dı) ]5 ∞ (2 ]immediately interr x† ° d ONLN d) ∞5= )S upted and then the new text buf @‡ ° d ONLN d&)>5® )éfer is spoken. When the . ° d ONLN d>6 ]B … (? ]kNoSpeechInterrupt ° d ONLN dP6 …B œ )l f PÄ ° d ONLN dR6 œB3 )lag bit is set, however ì ° d ONLN di62BC )c, a r eÄ ° d ONLN dn6CB‰ )%equest to speak on a channel that is . ° d ONLN dìC ]O ë (L ]still busy pr ⁄Ä ° d ONLN d†C ëO ˚ )4ocessing a prior text buf æ ° d ONLN dπC ˚O! )j
fer will r £@ ° d ONLN d√C!O] )&esult in an err h ° d ONLN d“C^Og )=or ‡ ° d ONLN d‘CgO£ ) . The new buf u† ° d ONLN d·C£O“ )< fer is ignor .Ä ° d ONLN dÌC”O‡ )0ed . ° d ONLN dP ]\ è (Y ] and the err R` ° d ONLN d˚P è\ ö )2or R` ° d ONLN d˛P ö\ Ë ) synthNotReady R` ° d ONLN d P Ë\ ¯ )N is r $¿ ° d ONLN dP ¯\v ) eturned. If the prior text buf ˜ ° d ONLN d.Pu\Δ )}fer has been fully . ° d ONLN dA] ]i f (f ]pr G ° d ONLN dC] gi ¬ )
ocessed, the new buf ⁄@ ° d ONLN dW] ¬i% )[fer is spoken normally ¿ ° d ONLN dm]$i) )b. . ° d ONLN dpo ]{ q (x ]The ° d ONLN dto q{ „ )kPreflightThenPause ° d ONLN dáo „{ Ï )r fl ° d ONLN däo Ï{È ) 8ag bit is used to minimize the latency experienced when ° d ONLN d¬| ]à … (Ö ]attempting to speak. Or R` ° d ONLN dŸ| …àH )l dinarily whenever a call to R` ° d ONLN dı|Hàä ) SpeakString R` ° d ONLN d |äàè )B, R` ° d ONLN d|èà≈ ) SpeakText R` ° d ONLN d |≈à’ )6, or ° d ONLN dâ ]ï ü (í ] SpeakBuffer ° d ONLN dâ üïÈ )BJ is made, the speech synthesizer must perform a certain amount of initial ˇl ◊# ˇ ˇˇˇˇ # ◊
ocessing befor ° d ONLN d ; ƒ G) )?e speech output is hear ܆ ° d ONLN d ' ;) GΩ )e#d. This startup latency can vary fr ? ° d ONLN d J ;æ GÈ )ï om a few ° d ONLN d S H { T ( Q {Wmilliseconds to several seconds depending upon which speech synthesizer is being used. ° d ONLN d ™ U { a ‘ *Recognizing that lar r† ° d ONLN d æ U ‘ aÌ )YAger startup delays may be detrimental to certain applications, a ° d ONLN d ˇ b { n √ ( k {mechanism is pr Ä ° d ONLN d b ƒ n ˙ )I ovided to pr ö¿ ° d ONLN d b ˙ nı )68ovide the synthesizer a chance to perform any necessary ° d ONLN dR o { {Ô ( x {Rcomputations at noncritical times. Once the computations have been completed, the . ° d ONLN d§ | { à *!speech is able to start instantly d@ ° d ONLN d≈ | à= )ç . When the ,
Courier d@ ° d ONLN d– |= àØ )5kPreflightThenPause d@ ° d ONLN d„ |Ø à∏ )r fl d@ ° d ONLN dÊ |∏ à ) ag bit is set, the . ° d ONLN d˘ â { ï Ì ( í {speech synthesizer will pr G¿ ° d ONLN d â Ó ï )s3ocess the input text as necessary to the point wher Ä ° d ONLN dF âÀ ïË )› e it is r w@ ° d ONLN dO âË ïˇ ) eady ° d ONLN dT ñ { ¢ ´ ( ü { to begin pr ô ° d ONLN d_ ñ ´ ¢ )0oducing speech output. ™‡ ° d ONLN dv ñ ¢ )j9At this point, the synthesizer will enter a paused state ° d ONLN dØ £ { Ø í ( ¨ {and r ≤ ° d ONLN d¥ £ í Ø fl )eturn to the caller fi` ° d ONLN d« £ fl ØS )M. When the application is r …` ° d ONLN d‚ £S ØÄ )t
eady to pr º‡ ° d ONLN dÏ £Ä Ø˚ )- oduce speech, it should call . ° d ONLN d ∞ { º ç ( π {the ° d ONLN d ∞ ç º · )ContinueSpeech ° d ONLN d ∞ · º Á )T r R` ° d ONLN d ∞ Á ºV )outine to begin speaking. . ° d ONLN d7 ÷ 9 fl S ( › 9RESUL ëÄ ° d ONLN d< ÷ S fl w )T CODES
5 9> 46 9= 7 97
ˇ·ˇ‚ˆA ° d ONLN d ( 96 Ø (2 9SpeechBusySystemW ±@ ° d ONLN d€( Ø6 ¿ )vide ˇˇˇˇˇˇ (21
. ° d ONLN d‡G {S Ç (P {Y ï ° d ONLN d·G ÅS Æ ) ou can use ï ° d ONLN dÏG ÆS& )-SpeechBusySystemWide ï ° d ONLN d G&Sº )x# to determine if any speech is curr g` ° d ONLN d#GºS )ñ ently being . ° d ONLN d/T {`< (] {+synthesized in your application or elsewher Ã` ° d ONLN dZT<`å )¡e on the computer >Ä ° d ONLN dkTå`é )P. . ° d ONLN dmm {y … (v {pascal short ° d ONLN dzm …yq )N SpeechBusySystemWide (void); . ° d ONLN dóï 9û r (ú 9 DESCRIPTION
oduced anywher $¿ ° d ONLN dØ œªO )Je on the Macintosh computer g` ° d ONLN d ØNªS ). g` ° d ONLN d!ØSªÀ )SpeechBusySystemWide g` ° d ONLN d5ØÀª— )x r 9¿ ° d ONLN d7Ø—ª ) eturns the ° d ONLN dBº {» (≈ { total number of speech channel ° d ONLN d`º» )ãs ° d ONLN daº » ) curr R` ° d ONLN dfº »› ))ently synthesizing speech on the computer ï ° d ONLN d躋»· )Ω, . ° d ONLN dë… {’ … (“ {whether they wer î ° d ONLN d°… …’ã )N,e initiated by your code or by some other pr é@ ° d ONLN dÕ…ã’— )¬ocess executing ° d ONLN d›÷ {‚ ù (fl {concurr f ° d ONLN d‰÷ ù‚ ≥ )"ently ü@ ° d ONLN dÈ÷ ≤‚ ¥ ). ° d ONLN dν 9 S ( 9RESUL ëÄ ° d ONLN d˝ S w )T CODES
° d ONLN d¯
{ ì +(None
5 9< 45 9; 6 {6
ˇ·ˇ‚ˆA ° d ONLN d˝' {5 ∏ * Converting †¿ ° d ONLN d' ∏5 ø )=T †¿ ° d ONLN d ' æ5" )ext Into Phonemes ˇˇˇˇˇˇ ‘@ (1 1
° d ONLN d ; {GÒ (D {YIn some situations it is desirable to convert a text string into its equivalent phonemic ° d ONLN duH {T ~ *r E ° d ONLN dvH T ç )epr ’¿ ° d ONLN dyH çT∞ )@esentation. This may be useful during the content development pr à¿ ° d ONLN dπH±T€ (Q±
ocess to fi v¿ ° d ONLN dƒH‹T )+ne-tune ° d ONLN dÃU {a ï (^ {the pr §Ä ° d ONLN d“U ïa ) onunciation of particular wor ⁄‡ ° d ONLN dÔUak )Çds or phrases. By fi › ° d ONLN dUka« )Trst converting the tar X¿ ° d ONLN dU»a¯ )] get phrase ° d ONLN d$b {n¸ (k {Vinto phonemes, you can see what the synthesizer will try to speak. Then you need only ° d ONLN dzo {{ å *corr ` ° d ONLN d~o ç{≠ )?ect the parts that would not have been spoken the way you want. . ° d ONLN dC ‰ { ô ( Ì {noErr . ° d ONLN dI ‰ )ò0 ° d ONLN dK ‰, H )No err E† ° d ONLN dQ ‰I R ) or . ° d ONLN dU Ô { ˚ … ( ¯ {synthNotReady . ° d ONLN dc Ô ˚ )â–242 ° d ONLN dh Ô, ˚Œ )(%Speech channel is still busy speaking . ° d ONLN dè ˙ { Á ( {invalidComponentID . ° d ONLN d¢ ˙ ˇ )Ñ–3000 . ° d ONLN d® ˙,Q )-Invalid ° d ONLN d∞ ˙Qü )%SpeechChannel ° d ONLN dΩ ˙ü— )N
ˇ·ˇ‚ˆA ° d ONLN d ; I # ( E T ,Ä ° d ONLN d ; " I 9 )extT ◊@ ° d ONLN d ; 8 I w ) oPhonemes ˇˇˇˇˇˇ ( E„1
. ° d ONLN d Z ] f q ( c ]The ,
Courier ° d ONLN d Z q f ≈ )TextToPhonemes ° d ONLN d " Z ≈ f À )T r R` ° d ONLN d $ Z À f± )3outine converts a designated text to phoneme codes. ° d ONLN d X s ] ´ ( | ]pascal OSErr ° d ONLN d e s ´ À )N0TextToPhonemes (SpeechChannel chan, Ptr textBuf, ° d ONLN d ü Å ˇ ç— +T# long textBytes, Handle phonemeBuf, ° d ONLN d Ã è ˇ õ} * long *phonemeBytes);
. ° d ONLN d ı µ ] ¡ u *chan . ° d ONLN d ˙ µ π ¡ ÷ )\Specifi ‡ ° d ONLN d µ ÷ ¡ ) c speech channel . ° d ONLN d ƒ ] – á ( Õ ]textBuf . ° d ONLN d ƒ π – » )\Buf … ° d ONLN d ƒ » – Ú ) fer of text . ° d ONLN d) ” ] fl ì ( ‹ ] textBytes ° d ONLN d3 ” π fl Ê )\
Length of ° d ONLN d= ” Ê fl )-textBuf ° d ONLN dD ” fl5 )* in bytes ° d ONLN dN ‚ ] Ó ô ( Î ]
phonemeBuf . ° d ONLN dY ‚ π Ó » )\Buf … ° d ONLN d\ ‚ » Ó )fer of phonemes . ° d ONLN dl Ò ] ˝ ´ ( ˙ ]*phonemeBytes ° d ONLN dz Ò π ˝ )\Pointer to length of ° d ONLN dè Ò ˝N )Y
phonemeBuf ° d ONLN dô ÒN ˝s )< in bytes . ° d ONLN d£ T ( DESCRIPTION
° d ONLN dØ$ ]0· +BVIt may be useful to convert your text into phonemes during application development in ° d ONLN d1 ]= f *or ∫Ä ° d ONLN d1 f= ≥ ) der to be able to r “ ° d ONLN d1 ≥=< )M educe the amount of memory r ±Ä ° d ONLN d61<=S )âequir »¿ ° d ONLN d;1S=fl )!ed to speak. If your application ° d ONLN d\> ]J â (G ]
does not r f ° d ONLN df> âJ † ),equir }` ° d ONLN dk> †J» )Be the text-to-phoneme conversion portion of the speech synthesizer 8@ ° d ONLN d≠>»JÕ (G», ° d ONLN dØK ]W x (T ]signifi ˚ ° d ONLN d∂K xW È )cantly less RAM may be r ` ° d ONLN dŒK ÍW )requir † ° d ONLN d”KW° )$ed to speak with some synthesizers. ± ° d ONLN d˜K°WŸ )† Additionally N ° d ONLN dKŸWfi )8, ° d ONLN dX ]dñ (a ]Eyou may be able to use a higher quality text-to-phoneme conversion pr }† ° d ONLN dJXñd› (añocess (even one ° d ONLN dZe ]q ¡ (n ]that does not work in r D@ ° d ONLN dqe ¬q( )eeal time) to generate pr ɇ ° d ONLN dâe(q )f*ecise phonemic information. This data can ° d ONLN d≥r ]~+ ({ ].then be used with any speech synthesizer to pr L† ° d ONLN d·r,~Ö )œoduce better speech. . ° d ONLN dˆÑ ]ê ± (ç ]TextToPhonemes ° d ONLN dÑ ±ê ˙ )T accepts a valid ° d ONLN dÑ ˙êH )ISpeechChannel ° d ONLN d"ÑHêz )N
parameter ¬† ° d ONLN d,ÑyêΔ )1, a pointer to the . ° d ONLN d?ë ]ù† (ö ]Jcharacters to be converted into phonemes, the length of the input text buf 6† ° d ONLN dâë°ù‰ (ö°fer in bytes, an ° d ONLN döû ]™‹ (ß ]Tapplication-supplied handle into which the converted phonemes can be written, and a . ° d ONLN dÓ´ ]∑ ≠ *length parameter ¬† ° d ONLN d˛´ ¨∑ ƒ )O. On r ï ° d ONLN d´ ƒ∑ Ú ) eturn, the ï ° d ONLN d´ Ú∑: ). phonemeBytes ï ° d ONLN d´:∑F )H ar g` ° d ONLN d ´F∑À ) gument is set to the number of ° d ONLN d=∏ ]ƒ ¯ (¡ ] phoneme character bytes that wer R` ° d ONLN d]∏ ¯ƒ7 )õe written into R` ° d ONLN dl∏7ƒs )?
phonemeBuf R` ° d ONLN dv∏sƒ® )< . The data r $¿ ° d ONLN dÇ∏®ƒŸ )5 eturned by ˇˇ÷à ° d ONLN dç≈ ]— ± (Œ ]TextToPhonemes ˇˇÚD ° d ONLN dõ≈ ±— Ÿ )T
will corr 6Ë ° d ONLN d•≈ ⁄— )) espond pr ˚å ° d ONLN dÆ≈—Ë )*1ecisely to the phonemes that would be spoken had ° d ONLN dfl“ ]fi “ (€ ] the input text been sent to ° d ONLN d˚“ “fi )u SpeakText ° d ONLN d“fi1 )6
instead. !† ° d ONLN d“1fiT ))All curr Ù ° d ONLN d“Sfi¨ )"ent mode settings ar Δ` ° d ONLN d*“¨fi )Ye applied to ˇˇrD ° d ONLN d7fl ]Î (Ë ]%the converted speech. No callbacks ar ç¥ ° d ONLN d\flÎh )®e generated while the ˇ˛Và Vƒ ° d ONLN drfliÎΩ )dTextToPhonemes ˇˇrD Vƒ ° d ONLN dÄflΩά )T r õh ° d ONLN dÇfl¬ÎË )
outine is . ° d ONLN dåÏ ]¯ º (ı ]generating its output. ° d ONLN d£ 5 ( RESUL ëÄ ° d ONLN d® 5 Y )T CODES
v }È 4v |È w ]wÈ
ˇ·ˇ‚ˆA ° d ONLN déh ]v Δ +(XGetting Information 1@ ° d ONLN d¢h Δv Ú )iAbout a ·¿ ° d ONLN d™h ÚvJ ),Speech Channel ˇˇˇˇˇˇ ‘@ )1
° d ONLN d∫| ]à‚ (Ö ]WSeveral additional types of information have been made available for advanced users of ° d ONLN dâ ]ï ∂ *the Speech Manager H¿ ° d ONLN d#â ∂ï )Y. This information pr ‚¿ ° d ONLN d8âïB )[
ovides mor ó¿ ° d ONLN dBâCï” )2"e detailed status information for . ° d ONLN dØ ], { () ]noErr . ° d ONLN dµ Ù, ˘ )ó0 ° d ONLN d∑ ,) )No err E† ° d ONLN dΩ *,3 ) or . ° d ONLN d¡+ ]7 ç (4 ]paramErr . ° d ONLN d + Í7 ˘ )ç–50 ° d ONLN dŒ+7Ä )#Parameter value is invalid . ° d ONLN dÍ6 ]B • (? ] nilHandleErr . ° d ONLN d˜6 ÂB ˘ )à–109 . ° d ONLN d¸6B< )( Handle ar R` ° d ONLN d6<Bh )/
gument is R` ° d ONLN d6hBz ),nil ° d ONLN dA ]M √ (J ]siUnknownInfoType . ° d ONLN d&A ÂM ˘ )à–231 ° d ONLN d+AM) )(Featur Á@ ° d ONLN d1A)Mæ ) e not implemented on synthesizer . ° d ONLN dSL ]X … (U ]invalidComponentID . ° d ONLN dfL ‡X ˘ )É–3000 . ° d ONLN dlLX2 )-Invalid ° d ONLN dtL2XÄ )%SpeechChannel ° d ONLN dÅLÄX≤ )N
ˇˇfi . ° d ONLN d ; { G ª ( D {each channel. h ° d ONLN d ; º G √ )AY #h ° d ONLN d ; ¬ G{ )+ou can get this information by calling the ,
Courier ˇˇö à ° d ONLN d : ;| G )∫GetSpeechInfo ˇˇfi à ° d ONLN d G ; Gœ )N r √Ï ° d ONLN d I ;œ G )outine. This . ° d ONLN d V H { T‚ ( Q {Rfunction accepts selectors that determine the type of information you want to get.
° d ONLN d Æ n { z ä *Thr 7 ° d ONLN d ± n ã z )oughout this document, ther h¿ ° d ONLN d à n z )~e ar w` ° d ONLN d – n zF ) e several r WÄ ° d ONLN d € nF zV )-efer † ° d ONLN d fl nW z¨ )ences to parameter ˇˇÄ . ° d ONLN d Ú z { Ü ∏ ( É {values specifi ° d ONLN d z π Ü Â )> ed with fi ° d ONLN d
z  ÜW ),xed-point integer values ( ˇ˛Ä ° d ONLN d$ zW Üo )rpbas ˇˇÄ ° d ONLN d( zo Üs ), ˇ˛Ä ° d ONLN d* zt Üå )pmod ˇˇÄ ° d ONLN d. zå Üê ), ˇ˛Ä ° d ONLN d0 zê Ü® )rate ˇˇÄ ° d ONLN d4 z® Üø ), and ° d ONLN d: Ü { í ì ( è {volm ° d ONLN d> Ü ì íñ )<). Unless otherwise stated, the full range of values of the ° d ONLN dz Üñ í¥ ( èñFixed ° d ONLN d Ü¥ í∂ ) . ° d ONLN dÄ í { û ı ( õ {data type is valid. However @ ° d ONLN dõ í ı ûæ )z2, it is left to the individual speech synthesizer ° d ONLN dÕ û { ™Ö ( ß {<implementation to determine whether or not to use the full r M‡ ° d ONLN d ûÜ ™± ( ßÜ
esolution . ° d ONLN d ™ { ∂ Δ ( ≥ {and range of the ° d ONLN d$ ™ Δ ∂ ‰ )KFixed ° d ONLN d) ™ ‰ ∂v ) ! data type. In the event a specifi ° d ONLN dK ™v ∂µ )íed parameter . ° d ONLN dX ∂ { ¬ú ( ø {Bvalue lies outside the range supported by a particular synthesizer ˙† ° d ONLN dö ∂õ ¬∞ ( øõ, the ° d ONLN d† ¬ { Œt ( À {;synthesizer will substitute the value closest to the specifi ‡ ° d ONLN d‹ ¬u Œ± )˙ed value that ° d ONLN dÍ Œ { ⁄" ( ◊ {&does lie within its performance specifi n† ° d ONLN d Œ# ⁄D )®cations. , Zapf Dingbats Ä ° d ONLN d —J ŸP )'u
soPitchMod ° d ONLN dç •÷ € )l = 'pmod', ° d ONLN dö Ì÷≥ )H!// gets current pitch modulation ° d ONLN dºÿ 9‰ o (· 9 soVolume ° d ONLN dÀÿ •‰ € )l = 'volm', ° d ONLN dÿÿ ̉≠ )H // gets current speaking volume ° d ONLN d˘Ê 9Ú { (Ô 9 soSynthType ° d ONLN d
Ê •Ú € )l = 'vers', ° d ONLN dÊ ÌÚπ )H"// gets speech synth version info ° d ONLN d:Ù 9 Å (˝ 9 soRecentSync ° d ONLN dLÙ • € )l = 'sync', ° d ONLN dYÙ Ì — )H&// gets most recent sync message info ° d ONLN dÄ 9 ô ( 9soPhonemeSymbols ° d ONLN dñ • · )l
= 'phsy', ° d ONLN d§ Ì≈ )H$// gets phoneme symbols & ex. words ° d ONLN d… 9 ô ( 9soSynthExtension ° d ONLN dfl • ’ )l= 'xtnd' ° d ONLN dÎ Ì π )H"// gets synthesizer-specific info ° d ONLN d 9* E (' 9};
. ° d ONLN d$D {P ì *chan . ° d ONLN d)D ◊P Ù )\Specifi ‡ ° d ONLN d0D ÙP> ) c speech channel . ° d ONLN dAS {_ ´ (\ {selector . ° d ONLN dJS ◊_R )\ Used to specify data being r £ ° d ONLN dfSR_y ){equested . ° d ONLN dob {n Ω (k { *speechInfo . ° d ONLN d{b ◊nT )\ Pointer to an information str Z ° d ONLN dòbUnl )~uctur ‡ ° d ONLN dùblnp )e ˇº ◊# ˇ ˇˇˇˇ # ◊
° d ONLN d I ] Uœ +BWThe following list of selectors describes the various types of information that can be ° d ONLN d c V ] b ç * obtained fr ˜Ä ° d ONLN d n V ç b ˜ )0om the Speech Manager â¿ ° d ONLN d É V ˜ bÜ )j!. The format of the information r ø ° d ONLN d § VÜ b· )èeturned depends on ° d ONLN d ∑ c ] o ¸ ( l ]%which value is used in the selector fi w‡ ° d ONLN d › c ˝ o> )†eld, as follows:
} ãÈ 4 ~ ãÈ ° d ONLN d Ó | ] á p ( Ñ ]Note
ˇ·ˇ‚ˆA
° d ONLN d Û â ] ï Ö * For futur `¿ ° d ONLN d ¸ â Ö ï fi )(e code compatibility “† ° d ONLN d â › ïB )X, use the application pr ª¿ ° d ONLN d( âB ïx )e
ogramming ° d ONLN d2 ï ] °I ( û ]:interface (API) labels instead of literal selector values. , Zapf Dingbats † ° d ONLN dm òO †U )Úu
Courier R` ° d ONLN dØ È: ıé )pinputBytesLeft R` ° d ONLN dΩ Èé ı– )T is 0, the input . ° d ONLN dŒ ı π « ( ˛ πbuf 5 ° d ONLN d— ı »≠ )4fer is no longer needed and can be disposed of. The † ° d ONLN d ı≠Á )ÂAPI label for ˇ˛ªJ . ° d ONLN d π ˘ (
πthis selector is ˇ¸1fi ±fi ° d ONLN d$ ˘) )@soStatus ˇ˛ªJ ±fi ° d ONLN d,), )0. ° d ONLN d4 ∑#ï ( ∑%typedef SpeechStatusInfo *speechInfo; ° d ONLN d_% ∑1} *!typedef struct SpeechStatusInfo { ° d ONLN dá3 …? Û +Boolean ° d ONLN dë3 ˇ?G )6 outputBusy; ° d ONLN d¢3Y?È )Z// true = audio playing ° d ONLN d¡A …M Û (J …Boolean ° d ONLN dÀA ˇMG )6 ouputPaused; ˇ˛Ã» ° d ONLN d‹AYMË )Z// true = channel paused ° d ONLN d¸O …[ · (X …long ° d ONLN dO ˇ[Y )6inputBytesLeft; ˇ˛Ã» ° d ONLN dOY[Ë )Z// bytes left to process ° d ONLN d7] …i Á (f …short ° d ONLN d?] ˇiG )6 phonemeCode; ° d ONLN dP]YiÈ )Z// current phoneme code ° d ONLN dok ∑w) (t ∑} SpeechStatusInfo; ° d ONLN dÉÉ ]è u (å ]erro . ° d ONLN dàÉ πè ¯ )\Gets saved err ¥ ° d ONLN dñÉ ¯èá )?!or information and clears the err ı ° d ONLN d∑Éáèñ )èor r ¢@ ° d ONLN dªÉóè” )egisters. This ° d ONLN d è πõM (ò π$selector lets you poll for various r Æ` ° d ONLN dÓèMõ )î un-time err §` ° d ONLN d˘èõfi )2ors that occur during ° d ONLN dõ πßø (§ π9speaking, such as the detection of badly formed embedded ° d ONLN dHß π≥ ¸ * commands. Err @ ° d ONLN dUß ˝≥ )Dors r ı` ° d ONLN dZß≥B ) eturned dir ˚ ° d ONLN deßB≥∂ )2ectly by Speech Manager r s@ ° d ONLN d~ß∑≥Ÿ )uoutines . ° d ONLN dÜ≥ πø √ (º πar R` ° d ONLN dà≥ √ø fi )
. ° d ONLN d ; { G ì ( D {inpt . ° d ONLN d ; ◊ G )\Gets the curr vÄ ° d ONLN d ; Gs )9ent value of the text pr ° d ONLN d * ;t GŒ )docessing mode contr w¿ ° d ONLN d = ;Œ GÓ )Zol. The ° d ONLN d E G ◊ S ⁄ ( P ◊r E ° d ONLN d F G € S7 )eturned value specifi œ ° d ONLN d [ G7 Sñ )\es whether the specifi c ° d ONLN d q Gó SÛ )`ed speech channel is . ° d ONLN d Ü S ◊ _ Ë ( \ ◊curr R` ° d ONLN d ä S Ë _[ )ently in text-input mode ( R` ° d ONLN d § S[ _s )sTEXT R` ° d ONLN d ® Ss _ )) or phoneme-input mode ˇ˛ÙX ° d ONLN d ¿ _ ◊ k € ( h ◊( ˇ¸› ° d ONLN d ¡ _ € k Û )PHON ˇ˛ÙX ° d ONLN d ≈ _ Û k )). The
-by-letter ·| ° d ONLN d ±? Ω^ ),, mode ( ˇ˙Ât zt ° d ONLN d! ±_ Ωw ) LTRL ˇ˛L| zt ° d ONLN d% ±w Ωê )). The µ ° d ONLN d, ±ê Ω ) API label for this selector is . ° d ONLN dK Ω ◊ …1 ( Δ ◊soCharacterMode ° d ONLN dZ Ω1 …3 )Z. . ° d ONLN db ” ’ flw ( ‹ ’typedef OSType *speechInfo; ° d ONLN d~ ”w fl◊ )¢// NORM or LTRL ° d ONLN dè Î { ˜ ì ( Ù {nmbr . ° d ONLN dî Î ◊ ˜ )\Gets the curr vÄ ° d ONLN d° Î ˜Ü )9ent value of the number pr ëÄ ° d ONLN dª ÎÜ ˜‡ )vocessing mode contr Ò ° d ONLN dŒ · ˜ )Zol. The ° d ONLN d÷ ˜ ◊ ⁄ ( ◊r E ° d ONLN d◊ ˜ €7 )eturned value specifi œ ° d ONLN dÏ ˜7ñ )\es whether the specifi c ° d ONLN d ˜óÛ )`ed speech channel is . ° d ONLN d ◊ Ë ( ◊curr R` ° d ONLN d Ë )ently pr $¿ ° d ONLN d# ‚ )$0ocessing input character digits in normal mode ( $¿ ° d ONLN dS‚˙ )÷NORM $¿ ° d ONLN dW˙ )) ° d ONLN dY ◊u ( ◊%or in literal, digit-by-digit, mode ( ° d ONLN d~uç )ûLTRL ° d ONLN dÇç™ )). The !† ° d ONLN d♸ ) API label for this ° d ONLN dú ◊' ($ ◊ selector is ° d ONLN d®'N )/ soNumberMode ° d ONLN d¥N'Q )H. ° d ONLN dª1 ’=w (: ’typedef OSType *speechInfo; ° d ONLN d◊1w=◊ )¢// NORM or LTRL ° d ONLN dËI {U ì (R {rate . ° d ONLN dÌI ◊U )\Gets the curr vÄ ° d ONLN d˙IU{ )9ent speaking rate in wor ~Ä ° d ONLN dI{Uı )kds per minute on the specifi H‡ ° d ONLN d.IˆU ){ed ° d ONLN d1U ◊aJ (^ ◊channel. Speaking rates ar ˙Ä ° d ONLN dKUJaW )se fi P‡ ° d ONLN dOUXa∫ )xed-point values. The @ ° d ONLN deU∫a )bAPI label for this . ° d ONLN dxa ◊m (j ◊ selector is ° d ONLN dÑam* )/soRate ° d ONLN däa*m- )$. ° d ONLN dëw ’Éq (Ä ’typedef Fixed *speechInfo; . ° d ONLN d¨í ◊ù Í +Note
Any specifi Ö† ° d ONLN d•√€œı )2c rate ° d ONLN d¨œ ◊€ ˛ (ÿ ◊may corr Ä ° d ONLN d¥œ ˇ€9 )(espond to dif N ° d ONLN d¡œ9€E ):fer 0† ° d ONLN dƒœE€á ) ent rates on dif :‡ ° d ONLN d‘œá€ì )Bfer ` ° d ONLN d◊œì€ ) ent synthesizers, but the ° d ONLN dÒ€ ◊Á4 (‰ ◊two rates should be r o‡ ° d ONLN d€4Áê )]easonably close. Mor ¡ ° d ONLN d€êÁà )\e importantly „ ° d ONLN d'€ÀÁ˙ ); , doubling ° d ONLN d2Á ◊Û ( ◊Ethe rate on a particular synthesizer should halve the time needed to ° d ONLN dwÛ ◊ˇ_ * speak any particular utterance. , Zapf Dingbats =† ° d ONLN dóˆe˛k )éu
. ° d ONLN dô { ì ( {pbas . ° d ONLN dû ◊ )\Gets the curr vÄ ° d ONLN d´õ )9!ent baseline pitch for the specifi C‡ ° d ONLN dÕú˝ )åed channel. The pitch ° d ONLN d„ ◊ ( ◊ value is a fi ëÄ ° d ONLN d ‡ )21xed-point integer that conforms to the following ° d ONLN d! ◊& fi (# ◊fr ò‡ ° d ONLN d# fi& ) equency r ‚ ° d ONLN d, &? )+elationship: . ° d ONLN d?0 ’<≈ (9 ’(Hertz = 440.0 * 2((BasePitch - 69) / 12) ° d ONLN dm> ’J * BasePitch ° d ONLN dv> J5 )6 of 1.0 ° d ONLN dÑ>SJX )H≈ ° d ONLN dÜ>eJè )9 Hertz ° d ONLN dìL ’X (U ’ BasePitch ° d ONLN dúL X; )6 of 39.5 ° d ONLN d´LSXX )H≈ ° d ONLN d≠LeXï )80 Hertz ° d ONLN dªZ ’f (c ’ BasePitch ° d ONLN dƒZ f; )6 of 45.8 ° d ONLN d”ZSfX )H≈ ° d ONLN d’Zefõ ) 115 Hertz ° d ONLN d‰h ’t (q ’ BasePitch ° d ONLN dÌh t; )6 of 50.4 ° d ONLN d¸hStX )H≈ ° d ONLN d˛hetõ ) 150 Hertz ° d ONLN dv ’Ç ( ’ BasePitch ° d ONLN dv ÇA )6 of 100.0 ° d ONLN d&vSÇX )H≈ ° d ONLN d(veÇ° )
. ° d ONLN d ; π G Ô ( D π BasePitch ° d ONLN d ; Ô G )6
values ar R` ° d ONLN d ; G‘ ),)e always positive numbers in the range fr $¿ ° d ONLN d < ;‘ G„ )πom ° d ONLN d ? G π S ◊ ( P π1.0 thr R` ° d ONLN d F G ◊ S ) ough 100.0. The Ù ° d ONLN d V G Sü )G API label for this selector is Ù ° d ONLN d u Gü S· )Å soPitchBase Ù ° d ONLN d Ä G· S‰ )B. ° d ONLN d á ] ∑ iS ( f ∑typedef Fixed *speechInfo; ° d ONLN d ¢ u ] Å u ( ~ ]pmod . ° d ONLN d ß u π Å Ú )\Gets the curr vÄ ° d ONLN d ¥ u Ú Å‘ )93ent pitch modulation range for the speech channel. ° d ONLN d Á Å π ç1 ( ä πModulation values range fr 9† ° d ONLN d Å2 ç^ )y
om 0.0 thr €‡ ° d ONLN d Å^ çí ), ough 100.0. Z† ° d ONLN d Åì çö )5A ï@ ° d ONLN d Åö ç— ) value of 0.0 ° d ONLN d& ç π ô ( ñ πcorr ` ° d ONLN d* ç À ô‰ )=esponds to no modulation and means the channel will speak in . ° d ONLN dg ô π • ( ¢ πa monotone. The !† ° d ONLN dw ô •Ö )K API label for this selector is !† ° d ONLN dñ ôÖ •¡ )Å
soPitchMod !† ° d ONLN d† ô¡ •Δ )<. . ° d ONLN d§ ® π ¥ ⁄ ( ± πNonzer §` ° d ONLN d™ ® ⁄ ¥I )!o modulation values corr ö ° d ONLN d¬ ®I ¥™ )oespond to pitch and fr 1¿ ° d ONLN dÿ ®´ ¥“ )bequency ° d ONLN d‡ ¥ π ¿ ( Ω πdeviations accor =† ° d ONLN d ¥ ¿â )H ding to the following formula: . ° d ONLN d ∑ ÷è ( ” ∑$Maximum pitch = BasePitch + PitchMod ° d ONLN d? ÿ ∑ ‰è *$Minimum pitch = BasePitch - PitchMod ° d ONLN di Ê ∑ Úe * Maximum Hertz = BaseHertz * 2 ° d ONLN dÜ ·e ÌÀ ( Íe(+ ModValue / 12) ° d ONLN dù Ù ∑ e ( ˝ ∑ Minimum Hertz = BaseHertz * 2 ° d ONLN d∫ Ôe ˚À ( ¯e(- ModValue / 12) ° d ONLN d— ∑ € ( ∑Given: ° d ONLN dfi … / +BasePitch of 46.0 ° d ONLN d˜Y j )ê(≈ ° d ONLN d˚k ≠ ) 115 Hertz), ° d ONLN d …*) (' …PitchMod of 2.0, ° d ONLN d#, ∑8 ’ (5 ∑Then: ° d ONLN d/: …F +Maximum pitch ° d ONLN d>: FA )T= 48.0 ° d ONLN dK:YF¶ )<(≈131 Hertz), ° d ONLN d_H …T (Q …Minimum pitch ° d ONLN dnH TA )T= 44.0 ° d ONLN d{HYT† )< (≈104 Hertz) ° d ONLN dçV ∑bS (_ ∑typedef Fixed *speechInfo; ° d ONLN d®n ]z u (w ]volm . ° d ONLN d≠n πz Ú )\Gets the curr vÄ ° d ONLN d∫n Úzy )9 ent setting of the volume contr ∂@ ° d ONLN dŸnyzæ )áol on the specifi &Ä ° d ONLN dÍnøzà )Fed ° d ONLN dÌz πÜ Á (É π
channel. V 2¿ ° d ONLN d˜z ÁÜ ). olumes ar ∑` ° d ONLN d zÜ- )+e expr ∫` ° d ONLN dz-ÜX )
ough 1.0. ◊Ä ° d ONLN d?Ü ˇí )*A ° d ONLN d@ÜíP ) value of 0.0 corr X@ ° d ONLN dRÜPíÊ )I#esponds to silence, and a value of ° d ONLN duí πû Ÿ (õ π1.0 corr ` ° d ONLN d}í ⁄û° )!)esponds to the maximum possible volume. V H ° d ONLN d¶í†û‰ )Δolume units lie ° d ONLN d∂û π™ò (ß π5on a scale that is linear with amplitude or voltage. Q‡ ° d ONLN dÎûò™ü )flA åÄ ° d ONLN dÏûü™◊ ) doubling of ° d ONLN d˘™ π∂ « (≥ πper ¿ ° d ONLN d¸™ »∂# )ceived loudness corr Ò¿ ° d ONLN d™"∂‹ )Z)esponds to a doubling of the volume. The . ° d ONLN d9∂ π¬: (ø π API label for this selector is ° d ONLN dX∂:¬j )ÅsoVolume ° d ONLN d`∂j¬m )0. ° d ONLN dgà ∑ÿS (’ ∑typedef Fixed *speechInfo; ° d ONLN dlj ] u (Ì ]vers . ° d ONLN dበπ– )\@Gets descriptive information for the type of speech synthesizer ° d ONLN d« π¸& * being used on the specifi ÷ ° d ONLN d‡&¸é )med speech channel. The C ° d ONLN d˜è¸‹ )iAPI label for this . ° d ONLN d
¸ π Ë ( π selector is ° d ONLN d¸ Ë* )/ soSynthType ° d ONLN d!¸*- )B. ° d ONLN d( ∑ õ ( ∑&typedef SpeechVersionInfo *speechInfo; ° d ONLN dT ∑,É *"typedef struct SpeechVersionInfo { ° d ONLN d}. …: Ì +OSType ° d ONLN dÜ. ˇ:; )6
synthType; ° d ONLN dñ.k:— )l// always 'ttsc' ° d ONLN dÆ< …H Ì (E …OSType ° d ONLN d∑< ˇHM )6synthSubType; ° d ONLN d <kHÀ )l// synth flavor ° d ONLN d·J …V Ì (S …OSType ° d ONLN dÍJ ˇVk )6synthManufacturer; ° d ONLN d˝JkV— )l// synth creator ° d ONLN dX …d · (a …long ° d ONLN d X ˇdA )6 synthFlags; ° d ONLN d-Xkd≥ )l // reserved ° d ONLN d@f …r (o …
NumVersion ° d ONLN dMfrY )< synthVersion; ° d ONLN d_fYr_ )T ° d ONLN dbfkr— )// synth version ° d ONLN dyt ∑Ä/ (} ∑} SpeechVersionInfo; ˇÊ ◊# ˇ ˇˇˇˇ # ◊
. ° d ONLN d ; { G ì ( D {sync ° d ONLN d ; ◊ G )\ Returns the ° d ONLN d ; G% )6sync ° d ONLN d ;% G† ) message code for the most r R` ° d ONLN d 1 ;† GÌ ){ecently encounter $¿ ° d ONLN d B ;Ì G˙ )Med ° d ONLN d E G ◊ S ( P ◊ embedded ° d ONLN d N G S )0sync ° d ONLN d R G SŸ )* command at the audio output point. If no ° d ONLN d | GŸ SÒ )∫sync ° d ONLN d Ä GÒ SÛ ) . ° d ONLN d Å S ◊ _[ ( \ ◊command has been encounter ü¿ ° d ONLN d õ S[ _ )Ñ
ed, 0 is r oÄ ° d ONLN d • SÄ _˛ )% eturned. Refer to the section ° d ONLN d √ _ ◊ kk ( h ◊“Embedded Speech Commands,” ”@ ° d ONLN d fi _k k‚ )î later in this document, for . ° d ONLN d ˚ k ◊ w* ( t ◊information about ° d ONLN d k* wB )Ssync ° d ONLN d kB wã ) commands. The !† ° d ONLN d kã w )I API label for this selector ° d ONLN d< w ◊ É · ( Ä ◊is ° d ONLN d? w · É) )
soRecentSync ° d ONLN dK w) É, )H. ° d ONLN dR ç ’ ôw ( ñ ’typedef OSType *speechInfo; ° d ONLN dn • { ± ì ( Æ {phsy . ° d ONLN ds • ◊ ±ø )\1Returns a list of phoneme symbols and example wor ò‡ ° d ONLN d§ •ø ±‹ )Ëds defi c¿ ° d ONLN d´ •› ±ˇ ) ned for ° d ONLN d≥ ± ◊ Ω ˘ ( ∫ ◊the curr ` ° d ONLN dª ± ˙ Ω< )#ent synthesizer ‡ ° d ONLN d ±< ΩÕ )B!. The input parameter is the addr ⁄@ ° d ONLN dÎ ±Õ ΩÔ )ë ess of a . ° d ONLN dÙ Ω ◊ …: ( Δ ◊handle variable. On r R` ° d ONLN d Ω: …h )c eturn, the R` ° d ONLN d Ωh …Œ ).PhonemeDescriptor R` ° d ONLN d% ΩŒ … )f parameter . ° d ONLN d0 … ◊ ’§ ( “ ◊-contains a handle to the array of phoneme defi 'Ä ° d ONLN d^ …• ’Ò )Œnitions. Make sur Á ° d ONLN do …Ò ’ )Le to ° d ONLN dt ’ ◊ ·o ( fi ◊!dispose of the handle when you ar Í¿ ° d ONLN dï ’o · )ò"e done using it. This information ° d ONLN d∑ · ◊ Ì™ ( Í ◊1is normally used to indicate to the user the appr ÍÄ ° d ONLN dË ·™ ÌÚ )”oximate sounds ° d ONLN d˜ Ì ◊ ˘ Ë ( ˆ ◊corr ` ° d ONLN d˚ Ì È ˘◊ )1esponding to various phonemes—an important featur } ° d ONLN d, Ì◊ ˘È )Óe in ° d ONLN d1 ˘ ◊H ( ◊international speech. The ’ ° d ONLN dK ˘H√ )q API label for this selector is . ° d ONLN dj ◊7 ( ◊soPhonemeSymbols ° d ONLN dz7: )`. ° d ONLN dÅ ’'Ô ($ ’/typedef PhonemeDescriptor ***speechInfo; // VAR ° d ONLN d√)ø5Ô +Í Handle ° d ONLN d—7 ’C} (@ ’ typedef struct PhonemeInfo { ° d ONLN dÙE ÁQ +short ° d ONLN d˚E Q5 )$opcode; ° d ONLN dEAQ› )6// opcode for the phoneme ° d ONLN d&S Á_ (\ ÁStr15 ° d ONLN d-S _/ )$phStr; ° d ONLN d6SA_Ô )6 // corresponding char string ° d ONLN dZa Ám (j ÁStr31 ° d ONLN daa mM )$ exampleStr; ° d ONLN dpaSmY )H ° d ONLN draem˚ )// word that shows use of ° d ONLN dôoe{ß * // phoneme ° d ONLN d´} Áâ (Ü Áshort ° d ONLN d≤} âS )$ hiliteStart; ° d ONLN d√}eâı )Z// part of example word ° d ONLN dÈãeóq *// ° d ONLN dÏãwó˚ )to be hilighted as in ° d ONLN d ô Á• (¢ Áshort ° d ONLN dô •G )$
. ° d ONLN d ; ∑ Gâ ( D ∑#typedef SpeechXtndData *speechInfo; ° d ONLN d ) I ∑ Uq * typedef struct SpeechXtndData { ° d ONLN d O W … c Ì +OSType ° d ONLN d X W ˇ cM )6synthCreator; ° d ONLN d f WM cÀ )N // synth creator ID ° d ONLN d Ç e … q · ( n …Byte ° d ONLN d â e ˇ qM )6synthData[2]; ° d ONLN d ó eM q— )N // data TBD by synth ° d ONLN d ≥ s ∑ ( | ∑} SpeechXtndData; . ° d ONLN d ≈ ö £ 5 ( ° RESUL ëÄ ° d ONLN d ö 5 £ Y )T CODES
Á ÓÈ 4 Ë ÓÈ È ] ÈÈ
ˇ·ˇ‚ˆA ° d ONLN d` ⁄ ] Ë Ô +(CAdvanced Control Routines ˇˇˇˇˇˇ ‘@ ( ‰‚1
° d ONLN d{ Û ] ˇ ≈ ( ¸ ]The Speech Manager pr +† ° d ONLN dê Û Δ ˇ )i ovides numer @ ° d ONLN dú Û ˇ, )= ous contr ` ° d ONLN d• Û, ˇQ )) ol featur @ ° d ONLN dÆ ÛQ ˇfi )%!es for sophisticated developers. ° d ONLN dœ ] ê ( ] These contr ć ° d ONLN d⁄ ê x )34ols enable you to set various speaking parameters pr ≠¿ ° d ONLN d x ” )Ëogrammatically and ° d ONLN d! ] f ( ]pr G ° d ONLN d# g · )
parameter ¬† ° d ONLN dJ9Eë )1", a selector to indicate the desir ï ° d ONLN dl9ëE‚ )éed function, and a . ° d ONLN dF ]R⁄ (O ]Xpointer to some data. The format of this data depends on the particular selector and is ° d ONLN d◊S ]_ „ * documented in the following r + ° d ONLN dÙS ‰_7 )áoutine description.
è òÈ 4ê óÈ ë ëÔ
ˇ·ˇ‚ˆA ° d ONLN dÇ ê j (å SetSpeechInfo ˇˇˇˇˇˇ (å„1
. ° d ONLN d° ]≠ q (™ ]The ° d ONLN d° q≠ ø )SetSpeechInfo ° d ONLN d(° ø≠ ≈ )N r R` ° d ONLN d*° ≈≠¡ )8outine sets information for a designated speech channel. ° d ONLN dc∫ ]Δ ´ (√ ]pascal OSErr ° d ONLN dp∫ ´Δ› )N3SetSpeechInfo (SpeechChannel chan, OSType selector, ° d ONLN d•» o‘ · (— o void *speechInfo); ° d ONLN dπ‡ Ï ? (È enum { ° d ONLN dÀ‡ ÛÏ} )ÿ// Sets the parameter: ° d ONLN d‰Ó -˙ o (˜ - soInputMode ° d ONLN dˆÓ ´˙ · )~ = 'inpt', ° d ONLN dÓ Û˙è )H// current text/phon mode ° d ONLN d ¸ - á ( -soCharacterMode ° d ONLN d5¸ ´ · )~ = 'char', ° d ONLN dB¸ Ûè )H// current character mode ° d ONLN d^
- u ( - soNumberMode ° d ONLN dq
´ · )~ = 'nmbr', ° d ONLN d~
Û} )H// current number mode ° d ONLN dó -$ Q (! -soRate ° d ONLN d§ ´$ · )~ = 'rate', ° d ONLN d± Û$â )H// current speaking rate ° d ONLN dÃ& -2 o (/ - soPitchBase ° d ONLN dfi& ´2 · )~ = 'pbas', ° d ONLN dÎ& Û2è )H// current baseline pitch ° d ONLN d4 -@ i (= -
soPitchMod ° d ONLN d4 ´@ · )~ = 'pmod', ° d ONLN d%4 Û@õ )H // current pitch modulation ° d ONLN dCB -N c (K - soVolume ° d ONLN dSB ´N · )~ = 'volm', ° d ONLN d`B ÛNï )H// current speaking volume ° d ONLN d}P -\ Å (Y -soCurrentVoice ° d ONLN díP ´\ · )~ = 'cvox', ° d ONLN düP Û\è )H// current speaking voice ° d ONLN dª^ -j ô (g -soCommandDelimiter ° d ONLN d‘^ ´j · )~ = 'dlim', ° d ONLN d·^ Ûjw )H// command delimiters ° d ONLN d˘l -x W (u -soReset ° d ONLN dl ´x · )~ = 'rset', ° d ONLN dl Ûx≠ )H // re channel to default state ° d ONLN d5z -Ü o (É - soCurrentA5 ° d ONLN dGz ´Ü · )~ = 'myA5', ° d ONLN dTz ÛÜâ )H// app's A5 on callbacks ° d ONLN doà -î ] (ë -soRefCon ° d ONLN d~à ´î · )~ = 'refc', ° d ONLN dãà Ûîw )H// reference constant ° d ONLN d — ® ] ¥ { ( ± ]noErr . ° d ONLN d ◊ ® Ù ¥ ˘ )ó0 ° d ONLN d Ÿ ® ¥) )No err E† ° d ONLN d fl ®* ¥3 ) or . ° d ONLN d „ ≥ ] ø √ ( º ]siUnknownInfoType . ° d ONLN d ı ≥  ø ˘ )à–231 ° d ONLN d ˙ ≥ ø) )(Featur Á@ ° d ONLN d ≥) ø» ) #e is not implemented on synthesizer . ° d ONLN d% æ ] … ( « ]invalidComponentID . ° d ONLN d8 æ ‡ ˘ )É–3000 . ° d ONLN d> æ 2 )-Invalid ° d ONLN dF æ2 Ä )%SpeechChannel ° d ONLN dS æÄ ≤ )N
. ° d ONLN d ; K G ∑ ( D KsoTextDoneCallBack ° d ONLN d ; … G ˇ )~ = 'tdcb', ° d ONLN d & ; G≥ )H// text done callback proc ° d ONLN d C I K U √ ( R KsoSpeechDoneCallBack ° d ONLN d ^ I … U ˇ )~ = 'sdcb', ° d ONLN d k I UÀ )H // end-of-speech callback proc ° d ONLN d å W K c ü ( ` KsoSyncCallBack ° d ONLN d ° W … c ˇ )~ = 'sycb', ° d ONLN d Æ W c≈ )H // sync command callback proc ° d ONLN d Œ e K q • ( n KsoErrorCallBack ° d ONLN d ‰ e … q ˇ )~ = 'ercb', ° d ONLN d Ò e qõ )H// error callback proc ° d ONLN d
. ° d ONLN d€ √ { œ ì *chan . ° d ONLN d‡ √ ◊ œ Ù )\Specifi ‡ ° d ONLN dÁ √ Ù œ> ) c speech channel . ° d ONLN d¯ “ { fi ´ ( € {selector . ° d ONLN d “ ◊ fiR )\ Used to specify data being r £ ° d ONLN d “R fiy ){equested . ° d ONLN d& · { Ì Ω ( Í { *speechInfo . ° d ONLN d2 · ◊ ÌT )\ Pointer to an information str Z ° d ONLN dO ·U Ìl )~uctur ‡ ° d ONLN dT ·l Ìp )e ° d ONLN dV 9 r ( 9 DESCRIPTION
° d ONLN d)T {`% *$The Speech Manager supports several ‡ ° d ONLN dMT%`e )™callback featur Y‡ ° d ONLN d\Tf`° )Aes that can pr ?` ° d ONLN djT°`º );ovide ° d ONLN dp` {læ (i {Jthe sophisticated developer with a tight coupling to the speech synthesis ° d ONLN d∫l {x Ñ * pr G ° d ONLN dºl Öx )
ocess. However ˝ ° d ONLN d l …x\ )D", these callbacks must be used car p† ° d ONLN dÏl]xv )îefully Ÿ` ° d ONLN dÚluxõ )
. ° d ONLN dñ8 {D ì *inpt . ° d ONLN dõ8 ◊D )\Sets the curr ° d ONLN d®8Dq )7ent value of the text pr ∂¿ ° d ONLN d¿8qDÀ )cocessing mode contr ` ° d ONLN d”8ÃDÏ )[ol. The ° d ONLN d€D ◊P/ (M ◊passed value specifi Ø ° d ONLN dÔD/P )X+es whether the speech channel should be in . ° d ONLN dP ◊\% (Y ◊text-input mode ( ° d ONLN d+P%\= )NTEXT ° d ONLN d/P=\≥ )) or phoneme-input mode ( ° d ONLN dHP≥\À )vPHON ° d ONLN dLPÀ\Ó ) ). Input . ° d ONLN dU\ ◊h6 (e ◊mode changes take ef b† ° d ONLN di\6h« )_!fect as soon as possible; however Δ` ° d ONLN dä\Δh )ê, the pr ͇ ° d ONLN dí\Âh¸ ) ecise ° d ONLN dòh ◊t{ (q ◊$latency is dependent upon the specifi ¿ ° d ONLN dΩh|t’ )•c speech synthesizer % ° d ONLN d—h’tÌ )Y. The Ä ° d ONLN d◊hÌt )API . ° d ONLN d€t ◊ÄD (} ◊label for this selector is ° d ONLN dˆtDÄÜ )m soInputMode ° d ONLN d tÜÄâ )B. ° d ONLN d ä ’ñ} (ì ’ typedef OSType *speechInfo; ° d ONLN d %ä}ñ› )®// TEXT or PHON ˇp ◊# ˇ ˇˇˇˇ # ◊
. ° d ONLN d ; ] G u ( D ]char . ° d ONLN d ; π G Ô )\Sets the curr ° d ONLN d ; Gk )7 ent value of the character pr ‚‡ ° d ONLN d / ;k G≈ ){ocessing mode contr BÄ ° d ONLN d B ;Δ GÊ )[ol. The ° d ONLN d J G π S ( P πpassed value specifi Ø ° d ONLN d ^ G S“ )X+es whether the speech channel should be in ˇˇC . ° d ONLN d â S π _ ( \ πnormal character pr ÿà ° d ONLN d ú S _S )Xocessing mode ( ˇ˝…< ^∞ ° d ONLN d ´ ST _l )CNORM ˇˇC ^∞ ° d ONLN d Ø Sl _∏ )) or literal, letter ˙L ° d ONLN d √ S∏ _ )L
-by-letter <Ï ° d ONLN d Õ S _È )-, ° d ONLN d œ _ π k ◊ ( h πmode ( ° d ONLN d ’ _ ◊ k Ô ) LTRL ° d ONLN d Ÿ _ Ô kâ )!). Character mode changes take ef R` ° d ONLN d ˙ _â k… )öfect as soon as . ° d ONLN d
k π w ( t πpossible; however †@ ° d ONLN d k w' )O, the pr ƒ¿ ° d ONLN d# k' wΔ ) $ecise latency is dependent upon the ° d ONLN dG w π É ’ ( Ä πspecifi Ó ° d ONLN dN w ’ É. ) c speech synthesizer Ä ° d ONLN db w/ ÉG )Z. The Ó‡ ° d ONLN dh wF É¡ ) API label for this selector is . ° d ONLN dá É π è ( å πsoCharacterMode ° d ONLN dñ É è )Z. ° d ONLN dù ô ∑ •_ ( ¢ ∑ typedef OSType *speechInfo; ° d ONLN d∫ ô_ •ø )®// NORM or LTRL ° d ONLN dÀ ± ] Ω u ( ∫ ]nmbr . ° d ONLN d– ± π Ω Ô )\Sets the curr ° d ONLN d› ± Ωf )7ent value of the number pr 0 ° d ONLN d˜ ±f Ω¿ )vocessing mode contr è¿ ° d ONLN d
the specifi KÄ ° d ONLN d Ì Ê ˘? )-c speech synthesizer n‡ ° d ONLN d3 Ì? ˘W )Y. The L@ ° d ONLN d9 ÌW ˘“ ) API label for this selector is . ° d ONLN dX ˘ π ( π soNumberMode ° d ONLN dd ˘ )H. ° d ONLN dk ∑_ ( ∑ typedef OSType *speechInfo; ° d ONLN dà_ø )®// NORM or LTRL ° d ONLN dô' ]3 u (0 ]rate . ° d ONLN dû' π38 )\ Sets the speaking rate in wor ê¿ ° d ONLN dª'83≤ )ds per minute on the specifi [ ° d ONLN d◊'≥3Á ){ ed channel. ° d ONLN d„3 π? (< πSpeaking rates ar d ° d ONLN dÙ3? )Le fi ∫Ä ° d ONLN d¯3?` )xed-point values. N ° d ONLN d
2637 Hertz ° d ONLN de π Ô ( π BasePitch ° d ONLN dn Ô )6
values ar R` ° d ONLN dx‘ ),)e always positive numbers in the range fr $¿ ° d ONLN d°‘„ )πom . ° d ONLN d§ π ’ ( π1.0 thr X¿ ° d ONLN d´ ’ ) ough 100.0. . ° d ONLN dº' ∑3S (0 ∑typedef Fixed *speechInfo; ° d ONLN dÿ? πK Õ +The !† ° d ONLN d‹? ÕKN ) API label for this selector is !† ° d ONLN d˚?NKê )Å soPitchBase !† ° d ONLN d?êKì )B. ° d ONLN dN ]Z u (W ]pmod . ° d ONLN dN πZ )\Changes the curr €‡ ° d ONLN d NZÊ )K3ent pitch modulation range for the speech channel. ° d ONLN dPZ πf1 (c πModulation values range fr 9† ° d ONLN djZ2f^ )y
om 0.0 thr €‡ ° d ONLN dtZ^fí ), ough 100.0. Z† ° d ONLN dÄZìfö )5A ï@ ° d ONLN dÅZöf— ) value of 0.0 ° d ONLN dèf πr (o πcorr ` ° d ONLN dìf Àr‰ )=esponds to no modulation and means the channel will speak in ° d ONLN d–r π~ ({ πa monotone. Nonzer † ° d ONLN d‚r~É )[o modulation values corr ˝@ ° d ONLN d˙rÇ~‹ )nespond to pitch and ° d ONLN d~ πä ¿ (á πfr ò‡ ° d ONLN d~ ¿ä/ )equency deviations accor ⁄¿ ° d ONLN d(~/ä¥ )o ding to the following formula: ˇ ◊# ˇ ˇˇˇˇ # ◊
soPitchMod !† ° d ONLN dà ̮ ˘´ )<. ° d ONLN dŒ ¸ { ì ( {volm . ° d ONLN d” ¸ ◊" )\Changes the curr €‡ ° d ONLN d„ ¸"ª )K!ent speaking volume on the specifi U@ ° d ONLN d ¸º )ö ed channel. ° d ONLN d ◊ fi ( ◊V ú` ° d ONLN d › ) olumes ar ! ° d ONLN d $ ),e expr $ ° d ONLN d!$O )
essed in fi Ä ° d ONLN d,P¬ ),xed-point units ranging fr ^@ ° d ONLN dF¬· )rom 0.0 ° d ONLN dM ◊ ‰ ( ◊thr X¿ ° d ONLN dP ‰ ) ough 1.0 . WÄ ° d ONLN d[ )-A í ° d ONLN d\ a ) value of 0.0 corr ÿ@ ° d ONLN dna ˜ )I#esponds to silence, and a value of ° d ONLN dë ◊, ˜ () ◊1.0 corr ` ° d ONLN dô ¯,ø )!)esponds to the maximum possible volume. V H ° d ONLN d¬ æ, )Δolume units lie ° d ONLN d“, ◊8∂ (5 ◊5on a scale that is linear with amplitude or voltage. Q‡ ° d ONLN d,∂8Ω )flA åÄ ° d ONLN d,Ω8ı ) doubling of ° d ONLN d8 ◊D  (A ◊per ¿ ° d ONLN d8 ÊDA )ceived loudness corr Ò¿ ° d ONLN d,8@D˙ )Z)esponds to a doubling of the volume. The . ° d ONLN dUD ◊PX (M ◊ API label for this selector is ° d ONLN dtDXPà )ÅsoVolume ° d ONLN d|DàPã )0. ° d ONLN dÉZ ’fq (c ’typedef Fixed *speechInfo; ° d ONLN dûr {~ ì ({ {cvox . ° d ONLN d£r ◊~" )\Changes the curr €‡ ° d ONLN d≥r"~| )Kent voice on the curr JÄ ° d ONLN d»r}~Ó )[ent speech channel to the ° d ONLN d‚~ ◊ä Û (á ◊specifi Ó ° d ONLN dÈ~ Ûär ) ed voice. Note that this contr /† ° d ONLN d~säß )Äol call will r #† ° d ONLN d~ßäŒ )4 eturn an . ° d ONLN d ä ◊ñ= (ì ◊incompatibleVoice ° d ONLN d/ä=ñL )f err R` ° d ONLN d3äLñé )or if the specif "‡ ° d ONLN dCäéñ )Bied voice is incompatible . ° d ONLN d]ñ ◊¢ (ü ◊Dwith the speech synthesizer associated with the speech channel. The . ° d ONLN d°¢ ◊ÆX * API label for this selector is ° d ONLN d¿¢Xƨ )ÅsoCurrentVoice ° d ONLN dŒ¢¨ÆØ )T. ° d ONLN d’∏ ’ƒâ (¡ ’ typedef VoiceSpec *speechInfo; ° d ONLN dÙ– {‹ ì (Ÿ {dlim . ° d ONLN d˘– ◊‹˚ )\@Sets the delimiter character strings for embedded commands. The ° d ONLN d9‹ ◊ˈ * <start of an embedded command is determined by comparing the ° d ONLN duË ◊Ù¯ * Binput characters to the start-command delimiter string. Likewise, ° d ONLN d∑Ù ◊ Ê * :the end of a command is determined by comparing the input ° d ONLN dÒ ◊ ‡ * 8characters to the end-command delimiter string. Command ° d ONLN d) ◊+ * delimiter strings ar Æ ° d ONLN d= +Ú )T2e either 1 or 2 bytes in length. If a single byte ° d ONLN do ◊$! (! ◊delimiter is desir Ê@ ° d ONLN dÅ!$‡ )J.ed, it should be followed by a null (0) byte. ° d ONLN dØ$ ◊0m (- ◊!Delimiter characters must come fr iÄ ° d ONLN d–$m0 )ñ$om the set of printable characters. ° d ONLN dÙ0 ◊<D (9 ◊If the delimiter strings ar =¿ ° d ONLN d0E<h )ne empty ‹‡ ° d ONLN d0g<¬ )", this will have the ef 4† ° d ONLN d-0√<‡ )\fect of ° d ONLN d5< ◊Hl (E ◊ disabling embedded command pr G¿ ° d ONLN dR<mHß )ñocessing. Car ñ ° d ONLN d_<ßHˇ ):e must be taken not ° d ONLN dsH ◊T˛ (Q ◊Fto choose delimiter strings that might occur naturally in the text to ˇˇ≠¿ . ° d ONLN dπT ◊` * be spoken. The *‡ ° d ONLN d»T`ô )C API label for this selector is ˇˇ @ =` ° d ONLN dÁTô` )soCommandDelimiter ˇˇ≠¿ ° d ONLN d˘T` )k. ˇ ◊# ˇ ˇˇˇˇ # ◊
. ° d ONLN d ; ∑ G · ( D ∑typedef ° d ONLN d ; · G Á )* ° d ONLN d ; Ì Gâ ) DelimiterInfo *speechInfo; ° d ONLN d + I ∑ U · ( R ∑typedef ° d ONLN d 4 I · U Á )* ° d ONLN d 6 I Ì Uq ) struct DelimiterInfo { ° d ONLN d R W ∑ c œ ( ` ∑Byte ° d ONLN d X W € c · )$ ° d ONLN d Z W Ì cY )startDelimiter[2]; ° d ONLN d q WY c_ )l ° d ONLN d t Wk c„ )// defaults to "[[" ° d ONLN d é e ∑ q œ ( n ∑Byte ° d ONLN d î e € q · )$ ° d ONLN d ñ e Ì qM )endDelimiter[2]; ° d ONLN d ≠ ek q„ )~// defaults to "]]" ° d ONLN d « s ∑ ( | ∑} DelimiterInfo; ° d ONLN d ÿ ã ] ó u ( î ]rset ° d ONLN d › ã π ó¢ )\5Resets the speech channel to its default states. The ° d ONLN d 㢠ófi )È
speechInfo ° d ONLN d ãfi ó‡ )< . ° d ONLN d ó π £X ( † π$parameter should be set to 0. Specifi „ ° d ONLN dB óX £∑ )üc synthesizers may pr ó ° d ONLN dW ó∏ £” )`ovide ˇˇ⁄à . ° d ONLN d] £ π Ø ◊ ( ¨ πother r -, ° d ONLN dd £ ÿ Ø< ) eset capabilities. The _0 ° d ONLN d{ £< غ )d API label for this selector is ˇˇêd ¯ ° d ONLN dö £º ØÊ )ÄsoReset ˇˇ⁄à ¯ ° d ONLN d° £Ê ØÈ )*. ° d ONLN d® π ∑ ≈M ( ¬ ∑typedef long *speechInfo; ° d ONLN d¬ — ] › u ( ⁄ ]myA5 . ° d ONLN d« — π ›Y )\&An application uses this selector to r £† ° d ONLN dÌ —Y ›º )†equest that the speech ° d ONLN d › π È ( Ê πsynthesizer set up an °¿ ° d ONLN d › È∑ )_&A5 world prior to all callbacks. In or iÄ ° d ONLN d@ ›∏ È )† der for an ° d ONLN dK È π ı ( Ú πCapplication to access any of its global data, it is necessary that ° d ONLN dé ı π º * r E ° d ONLN dè ı Ω ‹ )egister „` ° d ONLN dó ı ‹0 ) A5 contain the corr X† ° d ONLN d™ ı1‘ )U(ect value, since all global variables ar œÄ ° d ONLN d“ ı‘€ )£e ° d ONLN d‘ π º (
πr E ° d ONLN d’ Ω Õ )efer Ò ° d ONLN dŸ Õ Ì )enced r &¿ ° d ONLN d‡ Ó )! elative to r @ ° d ONLN dÏ ; ).egister é† ° d ONLN dÙ<Á ) (A5. If you pass a non-null value in the ˇ˛m . ° d ONLN d π ı ( π
Sets the r ´ ° d ONLN dµ ·¡ Ò )(efer W@ ° d ONLN dµ Ú¡£ )(ence constant associated with the specifi ‡ ° d ONLN d<µ§¡ÿ )≤ ed channel. ¢@ ° d ONLN dHµÿ¡Ë )4All ° d ONLN dL¡ πÕp ( π+callbacks generated for this channel will r Û¿ ° d ONLN dw¡pÕ° )∑ eturn this r … ° d ONLN dÉ¡°Õ± )1efer u ° d ONLN dá¡≤Õ» )ence ° d ONLN dåÕ πŸ” (÷ πBconstant for use by the application. The application can use this ° d ONLN dŒŸ πÂB * value any way it wants to. The ¿ ° d ONLN dÌŸCÂæ )ä API label for this selector is . ° d ONLN d  πÒ È (Ó πsoRefCon ° d ONLN d ÈÒ Ï )0. ° d ONLN d˚ ∑M ( ∑typedef long *speechInfo; ° d ONLN d5 ] u ( ]tdcb . ° d ONLN d: π î )\4Enables the callback that signals that text input pr $ ° d ONLN dnï · )‹ocessing is done. ° d ONLN dÄ π+ ø (( πY @Ä ° d ONLN dÅ ø+ ˚ )our callback r <¿ ° d ONLN dè ˚+à )< outine is invoked when the curr >@ ° d ONLN dÆ à+ß )çent buf P† ° d ONLN dµ ß+€ ) fer of input ° d ONLN d¬+ π7 ˛ (4 πtext has been pr 8¿ ° d ONLN d“+ ˇ7Œ )F.ocessed and is no longer needed by the speech ° d ONLN d 7 πC Î (@ π synthesizer ° d ONLN d 7 ÎC‹ )2:. This callback does not indicate that the synthesizer is ˇˇff . ° d ONLN dEC πO ¿ (L πfi ° d ONLN dGC ¿OT )"nished speaking the text (see the ˇ˛32 Êd ° d ONLN diCTOl )îsdcb ˇˇff Êd ° d ONLN dmClOË ) callback description, next), . ° d ONLN dãO π[ (X πmer ‚† ° d ONLN déO [u ))ely that the input text has been fully pr P@ ° d ONLN d∑Ov[‰ )¨ocessed and is no longer ° d ONLN d–[ πgL (d π needed by the speech synthesizer ç ° d ONLN d[Lg· )ì#. This callback can be disabled by . ° d ONLN dg πs ˘ (p πpassing a null ° d ONLN d"g ˘s# )@ProcPtr ° d ONLN d)g#sB )* in the ° d ONLN d1gBs~ )
speechInfo ° d ONLN d;g~s∞ )<
parameter ¬† ° d ONLN dEgØsË )1 . When your . ° d ONLN dQs π „ (| π
° d ONLN d ; ◊ GR ( D ◊speaking without any interr Í` ° d ONLN d ;R GÏ ){%uption in the output. If you set the ,
Courier . ° d ONLN d @ G ◊ S ( P ◊nextBuf ° d ONLN d G G Ss )* parameter to null, you ar R` ° d ONLN d a Gs S˙ )r e indicating that you have no ° d ONLN d S ◊ _ Ë ( \ ◊mor R` ° d ONLN d Ç S Ë _B )e text to speak. The R` ° d ONLN d ó SB _ä )Z controlFlags R` ° d ONLN d £ Sä _⁄ )H parameter is defi R` ° d ONLN d µ S⁄ _ )P
parameter ¬† ° d ONLN d ˇD ] )1. The d@ ° d ONLN d ˇ] fi ) API label for this selector is ° d ONLN d. ◊O ( ◊soSpeechDoneCallBack ° d ONLN dB OR )x. ° d ONLN dI! ’-_ (* ’typedef Ptr speechInfo; ° d ONLN df/ ’;ı *0pascal void MyEndOfSpeechCallback (SpeechChannel ° d ONLN dù= ÁI_ + chan, long refCon); ° d ONLN d≤U {a ì (^ {sycb ° d ONLN d∑U ◊a )\ Enables the ° d ONLN d√Ua& )7sync ° d ONLN d«U&aÄ ) command callback. R` ° d ONLN d⁄UÄaá )ZY g` ° d ONLN d€UÜa√ )our callback r 9¿ ° d ONLN dÈU√aÎ )=
outine is ° d ONLN dÛa ◊mu (j ◊"invoked when the text following a ° d ONLN daumç )ûsync ° d ONLN daçmı ) embedded command is . ° d ONLN d.m ◊yˇ (v ◊Dabout to be spoken. This callback can be disabled by passing a null . ° d ONLN dry ◊Ö * ProcPtr ° d ONLN dyyÖ )* in the ° d ONLN dÅy Ö\ )
speechInfo ° d ONLN dãy\Öé )<
parameter ¬† ° d ONLN dïyçÖ§ )1. See ¬† ° d ONLN dõy§Ö˝ )“Embedded Speech . ° d ONLN d¨Ö ◊ë (é ◊
ocess. If ° d ONLN d# ◊/ „ (, ◊err @ ° d ONLN d# ‰/∑ )/or callbacks have not been enabled, when an err ´Ä ° d ONLN d5#∑/˘ )”or condition is ° d ONLN dE/ ◊;— (8 ◊9detected, the Speech Manager will save its value. The err –† ° d ONLN d~/—;¯ )˙ or codes . ° d ONLN dá; ◊G (D ◊can then be r R` ° d ONLN dî;GM )8ead using the R` ° d ONLN d¢;MGõ )>GetSpeechInfo R` ° d ONLN dØ;õGfl )N status selector ° d ONLN d¿G ◊S (P ◊soErrors ° d ONLN d»GS )0 ( ° d ONLN d GS% )erro ° d ONLN dŒG%SO )
). The err R` ° d ONLN dÿGOS )*)or callback can be disabled by passing a ˇˇé( ° d ONLN dS ◊_ Í (\ ◊null ˇ˛™x ( ° d ONLN dS Î_ )ProcPtr ˇˇé( ( ° d ONLN dS_2 )* in the ˇ˛™x ∏† ° d ONLN dS2_n )
speechInfo ˇˇé( ∏† ° d ONLN d Sn_ü )<
parameter âh ° d ONLN d)Sü_∑ )1. The GX ° d ONLN d/S∑_ )API label for this ° d ONLN dB_ ◊k (h ◊ selector is ° d ONLN dN_k` )/soErrorCallBack ° d ONLN d]_`kc )Z. ° d ONLN ddu ’Å_ (~ ’typedef Ptr speechInfo; ° d ONLN dÅÉ ’èı *0pascal void MyErrorCallback (SpeechChannel chan, ° d ONLN d∏ë Áù› +) long refCon, OSErr error, long bytePos); ˇV ◊# ˇ ˇˇˇˇ # ◊
. ° d ONLN d ; ] G u ( D ]phcb . ° d ONLN d ; π G6 )\Enables phoneme callbacks. <¿ ° d ONLN d ;7 G= )~Y ˝@ ° d ONLN d ! ;< Gx )our callback r ˘Ä ° d ONLN d / ;x G÷ )<outine is invoked for ° d ONLN d E G π SΔ ( P π;each phoneme generated by the speech synthesizer just befor <Ä ° d ONLN d Ä G« Sfi ( P«e the ° d ONLN d Ü S π _… ( \ π=phoneme is actually spoken. This callback can be disabled by . ° d ONLN d √ _ π k ˘ * passing a null ° d ONLN d “ _ ˘ k# )@ProcPtr ° d ONLN d Ÿ _# kB )* in the ° d ONLN d · _B k~ )
parameter ¬† ° d ONLN dó Ÿo Âà )1. The d@ ° d ONLN dù Ÿà Â⁄ )API label for this ° d ONLN d∞  π Ò Ë ( Ó π selector is ° d ONLN dº Â Ë Ò< )/soWordCallBack ° d ONLN d Â< Ò? )T. ° d ONLN d— ˚ ∑A ( ∑typedef Ptr speechInfo; ° d ONLN dÓ ∑◊ *0pascal void MyWordCallback (SpeechChannel chan, ° d ONLN d% …#≈ +*long refCon, long wordPos, short wordLen); ° d ONLN dP/ ]; u (8 ]xtnd . ° d ONLN dU/ π;„ )\DThis call supports a general method for extending the functionality ° d ONLN dô; πG * of the Speech Manager í ° d ONLN dÆ; Gò )d . It is used to set synthesizer 1† ° d ONLN dÕ;ôG∏ )|-specifi Û† ° d ONLN d’;∏Gæ ) c . ° d ONLN d◊G πS (P πinformation. The ° d ONLN dËGSD )O
speechInfo ° d ONLN dÚGDSP )< ar R` ° d ONLN dıGPSÁ ) "gument should be a pointer to the ˇˇÔÍ ° d ONLN dS π_ œ (\ πappr R` ° d ONLN dS œ_ )opriate data str 4 ° d ONLN d+S_- )Huctur î ° d ONLN d0S,_x )e. If a particular ˇˇœæ ∞< ° d ONLN dCSy_¡ )M synthCreator ˇˇÔÍ ∞< ° d ONLN dOS¡_Ë )H
value is . ° d ONLN dY_ πk Õ (h πnot r N@ ° d ONLN d^_ ŒkM ) ecognized by the synthesizer ? ° d ONLN dz_Mk≤ ), the command is ignor ¿ ° d ONLN dê_≤k‡ )e
ed and an . ° d ONLN dök πw (t πsiUnknownInfoType ° d ONLN d´k wE )f
ˇ·ˇ‚ˆA ° d ONLN dÀB ]P ± +(YApplication-Defi Ç@ ° d ONLN d€B ±PS )T ned Pronunciation Dictionaries ˇˇˇˇˇˇ ‘@ (L‚1
° d ONLN d˚V ]br (_ ]>No matter how sophisticated a speech synthesis system is, ther Ä ° d ONLN d9VsbÕ (_se will always be wor œÄ ° d ONLN dMVÕbŸ )Zds ° d ONLN dPc ]o Í (l ]!that it does not automatically pr ˜ ° d ONLN dqc Ío$ )ç onounce corr „ ° d ONLN d}c$o8 ):ectly ª ° d ONLN dÇc8oe ) . The clear fi ° d ONLN dçceo∑ )-est instance of wor F` ° d ONLN d†c∏o· )S
° d ONLN d ; { G … ( D {One way to get ar ı ° d ONLN d ; … Gå )N-ound this fundamental limitation is to use a •‡ ° d ONLN d > ;ç G» )ƒdictionary of ° d ONLN d L H { T Ñ ( Q {pr G ° d ONLN d N H Ö T¡ )
Eonunciations. Whenever a speech synthesizer needs to determine the pr À‡ ° d ONLN d ì H¡ T ( Q¡oper phonemic ° d ONLN d ° U { a ~ ( ^ {r E ° d ONLN d ¢ U a ç )epr ’¿ ° d ONLN d • U ç a ) esentation for a particular wor Í¿ ° d ONLN d ƒ U a, )Üd, it fi æ ° d ONLN d à U- aÜ )rst looks for the wor ˙` ° d ONLN d · UÜ afl )Yd in its dictionaries. ° d ONLN d ¯ b { n Ñ ( k {Pr N† ° d ONLN d ˙ b Ö n® )
Bonunciation dictionary entries contain information that enables pr |Ä ° d ONLN d< b® nÚ ( k®ecise conversion ° d ONLN dM o { { Î ( x {between text and the corr Æ ° d ONLN df o Î {z )p ect phoneme codes. They also pr a ° d ONLN dÖ o{ {° )ê ovide str ‡ ° d ONLN dé o¢ {˙ )'ess, intonation, and ° d ONLN d£ | { àP ( Ö {0other information to help speech synthesizers pr 2‡ ° d ONLN d” |Q àÄ )÷ oduce mor ì† ° d ONLN d‹ |Ä à¯ )/ e natural speech. If the wor à` ° d ONLN d¯ |¯ à )xd ° d ONLN d˙ â { ï ( í {&in question is found in the dictionary ` ° d ONLN d â ï„ )£., then the synthesizer uses the information fr ˝` ° d ONLN dN â‚ ï )ƒom the ° d ONLN dU ñ { ¢ ¸ ( ü { dictionary entry rather than r ≥† ° d ONLN ds ñ ¸ ¢a )Åelying on its own letter OÄ ° d ONLN dã ñb ¢ì )f -to-sound r ¥Ä ° d ONLN dñ ñì ¢⁄ )1ules. The use of ° d ONLN dß £ { Ø Ì ( ¨ {phonemes is described in ¯` ° d ONLN d¿ £ Ì Øx )r“Summary of Phonemes and Pr ¥@ ° d ONLN d€ £y ر )å osodic Contr 5‡ ° d ONLN dÁ £≤ ØΔ )9ols,” P¿ ° d ONLN dÏ £Δ ظ ) later in this ° d ONLN d˚ ∞ { º ™ ( π { document. ° d ONLN d ¬ { Œ Î *The Speech Manager wor ˆ ° d ONLN d ¬ Î Œ@ )pd storage format pr kÄ ° d ONLN d. ¬A ŒÕ )V!ovides high-quality data that is ° d ONLN dO œ { € è ( ÿ {inter
¿ ° d ONLN dT œ ê €˙ )Ochangeable between speech synthesizers. The Speech Manager also uses an easily ° d ONLN d£ ‹ { Ë Â (  {extensible dictionary str t` ° d ONLN dº ‹ Â Ë ¸ )juctur ˙@ ° d ONLN d¡ ‹ ¸ ËG )e that does not af a` ° d ONLN d” ‹H Ë˙ )L,fect the usability of existing dictionaries. ° d ONLN d Ó { ˙ ( ˜ {"It is assumed that application-defi ”¿ ° d ONLN d# Ó ˙. )ñned pr —† ° d ONLN d) Ó. ˙≥ ) onunciation dictionaries will r ÿ ° d ONLN dH Ó≥ ˙Ò )Öeside in RAM ° d ONLN dU ˚ { à ( {when in use. The r %@ ° d ONLN dg ˚ Õ ˝ )R un-time str ¯ ° d ONLN dr ˚ ˝ )0uctur }‡ ° d ONLN dw ˚w )e of dictionary data pr ù‡ ° d ONLN dé ˚wÍ )besumably depends on the ° d ONLN d¶ { ó ( {specifi Ó ° d ONLN d≠ óÖ ) 7c needs of particular speech synthesizers and will ther § ° d ONLN d‰Üó )Ôefor ¸ ° d ONLN dËó™ )e dif p ° d ONLN dÌ´¿ )fer fr ° d ONLN dÛ¡‚ )om the ° d ONLN d˙ {! Ü ( {str fi ° d ONLN d˝ Ü! ù ) uctur c‡ ° d ONLN d û! ) e of the dictionaries as stor ¿ ° d ONLN d !D )v ed on disk.
? 9F 4@ 9F A {A
ˇ·ˇ‚ˆA ° d ONLN d+2 {@ (< {Associating a Dictionary W - ° d ONLN dE2
@| )èith a Speech Channel ˇˇˇˇˇˇ ‘@ )ˆ1
° d ONLN d[F {R ø (O {The following r ∞@ ° d ONLN djF øR† )D3outines can be used to associate an application-defi F@ ° d ONLN dûF°Ræ )‚ned pr D ° d ONLN d§FæRı ) onunciation ° d ONLN d∞S {_< (\ {,dictionary with a particular speech channel.
è 9ò 4ê 9ó ë 9ë
ˇ·ˇ‚ˆA ° d ONLN d›Ç 9ê à (å 9UseDictionary ˇˇˇˇˇˇ (å1
. ° d ONLN dÏ° {≠ è (™ {The ,
Courier ° d ONLN d° è≠ › )UseDictionary ° d ONLN d˝° ›≠ „ )N r R` ° d ONLN dˇ° „≠fi )7outine associates a designated dictionary with a specifi R` ° d ONLN d7°fi≠ )˚ c speech . ° d ONLN d@Æ {∫ † (∑ {channel. . ° d ONLN dI« {” … *pascal OSErr ° d ONLN dV« …”ø )N)UseDictionary (SpeechChannel chan, Handle ° d ONLN dÇ’ ü· Ì (fi ü dictionary);
Ô 9˛ 4Ô 9˝ . ° d ONLN dêÓ {˘ « (ˆ {Field descriptions
ˇ·ˇ‚ˆA
. ° d ONLN d£˚ { ì *chan . ° d ONLN d®˚ ◊ Ù )\Specifi ‡ ° d ONLN dØ˚ Ù> ) c speech channel . ° d ONLN d¿
{ ∑ ( {
dictionary . ° d ONLN dÀ
◊2 )\Handle to the specifi Û‡ ° d ONLN d‡
2l )[ed dictionary ° d ONLN dÓ0 99 r (7 9 DESCRIPTION
° d ONLN d˙= {I› +BQThe speech synthesizer will attempt to use the dictionary data pointed to by the . ° d ONLN dKJ {V ∑ *
dictionary ° d ONLN dUJ ∑V Ê )<
handle ar R` ° d ONLN d_J ÊV| )/!gument to augment the built-in pr $¿ ° d ONLN dÄJ|V∂ )ñonunciation r ¿ ° d ONLN dçJ∂VË ): ules on the . ° d ONLN dôW {c ó (` {specifi Ó ° d ONLN d†W óc˚ ) Ped speech channel. The synthesizer will use whatever elements of the dictionary ° d ONLN dd {p ~ (m {r E ° d ONLN dÒd p ó )esour ç@ ° d ONLN dˆd ópn )2ce it considers useful to the speech conversion pr *¿ ° d ONLN d(dopã )ÿocess. ı¿ ° d ONLN d/däpß )After r TÄ ° d ONLN d6d®p◊ ) eturning fr ` ° d ONLN dAdÿpË )0om . ° d ONLN dDq {} … (z {UseDictionary d@ ° d ONLN dQq »} )M, the caller is fr 6† ° d ONLN dcq}) )Fee to r ° d ONLN djq)}ˇ )elease any storage allocated for the dictionary . ° d ONLN dö~ {ä √ (á {handle. The sear ˜‡ ° d ONLN d™~ √ä Ÿ )Hch or Ù ° d ONLN dØ~ Ÿä8 )der for application-pr Y‡ ° d ONLN d≈~9ä¿ )`!ovided dictionaries is last in, fi z` ° d ONLN dÁ~¿äfl )árst sear 8 ° d ONLN dÔ~‡ä˜ ) ched. ˇ
° d ONLN d ; ] G ˙ ( D ]$All details of how an application-pr ÿ ° d ONLN d $ ; ˙ GY )ùovided dictionary is r Ø` ° d ONLN d : ;Y Gg )_epr @ ° d ONLN d = ;h G‹ )esented within the speech ° d ONLN d W H ] T ö ( Q ]synthesizer ar !Ä ° d ONLN d e H õ T )>e dependent on the specifi ˘ ° d ONLN d H TØ )s#c synthesizer implementation and ar Ä ° d ONLN d ¢ H∞ T÷ )¢
e totally ° d ONLN d ¨ U ] a Õ ( ^ ]private to the synthesizer √¿ ° d ONLN d Δ U à a Œ )o. ° d ONLN d » { Ñ 5 ( Ç RESUL ëÄ ° d ONLN d Õ { 5 Ñ Y )T CODES
” ⁄È 4 ‘ ⁄È ’ ] ’È
ˇ·ˇ‚ˆA ° d ONLN dõ Δ ] ‘% +(N$Pronunciation Dictionary Data Format ˇˇˇˇˇˇ ‘@ ( –‚1
° d ONLN d¡ ⁄ ] Ê ∫ ( „ ]Each application-defi Z@ ° d ONLN d÷ ⁄ ª Ê ÿ )^ned pr X ° d ONLN d‹ ⁄ ÿ Ê ) onunciation ¡¿ ° d ONLN dË ⁄ Êπ )7'dictionary is implemented as a single r ê ° d ONLN d ⁄∫ Ê“ )´esour ÿ@ ° d ONLN d ⁄“ Ê› )ce . ° d ONLN d Á ] Û ( ]of type ,
Courier ° d ONLN d Á Û £ )"'dict' ° d ONLN d% Á £ Û Æ )$. T ï ° d ONLN d( Á ≠ Û ∏ )
o r g` ° d ONLN d+ Á ∏ Ûr ) )ead the dictionary contents, the system fi g` ° d ONLN dU Ár ÛÑ )∫rst r 9¿ ° d ONLN dZ ÁÑ Û± )
eads the r ° d ONLN dd Á± Û» )-esour fiÄ ° d ONLN di Á« ÛÊ )ce into . ° d ONLN dq Ù ] ø ( ˝ ]memory using Resour l ° d ONLN dÑ Ù ø ¯ )b ce Manager r ˝ ° d ONLN dê Ù ¯ )9outines. ° d ONLN dô ]m ( ]=An application dictionary contains the following information: ° d ONLN dÚ¿ ]Ã Ç *∫The curr Í¿ ° d ONLN d˙¿ Çà ´ )% ently defi ±¿ ° d ONLN d¿ ¨Ã ı )*ned atom type is ° d ONLN d+Í ]ˆ ¸ (Û ]%Each entry consists of the following: ° d ONLN d√D ]P Ç *ZThe curr Í¿ ° d ONLN dÀD ÇP ´ )% ently defi ±¿ ° d ONLN d’D ¨P ¸ )*ned entry types ar ʇ ° d ONLN dÁD ¸P@ )Pe the following: . ° d ONLN d ‘ â ] ï { ( í ]noErr . …& ° d ONLN d ⁄ â ˚ ï )û0 …& ° d ONLN d ‹ â ï0 )No err éΔ ° d ONLN d ‚ â1 ï: ) or . ° d ONLN d Ê î ] † ô ( ù ]
memFullErr . …& ° d ONLN d Ò î Ï † )è–108 …& ° d ONLN d ˆ î †” )('Not enough memory to use new dictionary . ° d ONLN d ü ] ´ ´ ( ® ]badDictFormat . …& ° d ONLN d- ü Ï ´ )è–246 …& ° d ONLN d2 ü ´@ )( Format pr Ê ° d ONLN d; üA ´ )-oblem with pr ªF ° d ONLN dH ü ´„ )>onunciation dictionary . ° d ONLN d` ™ ] ∂ … ( ≥ ]invalidComponentID . …& ° d ONLN ds ™ Á ∂ )ä–3000 . …& ° d ONLN dy ™ ∂9 )-Invalid …& ° d ONLN dÅ ™9 ∂á )%SpeechChannel …& ° d ONLN dé ™á ∂π )N
parameter . ° d ONLN d÷ ]$ • (! ]total byte length ° d ONLN dË ”$ Ì )v(long) ° d ONLN dÔ $s )9(Length is all-inclusive) ° d ONLN d
( ]4 â (1 ] atom type ° d ONLN d( ”4 Ì )v(long) ° d ONLN d 8 ]D û (A ]format version ° d ONLN d,8 ”D Ì )v(long) ° d ONLN d5H ]T ç (Q ] script code ° d ONLN dAH ”T )v(short) ° d ONLN dKX ]d ú (a ]language code ° d ONLN dYX ”d )v(short) ° d ONLN dch ]t ` (q ]r E ° d ONLN ddh at ê )
egion code ° d ONLN doh ”t )r(short) ° d ONLN dyx ]Ñ ° (Å ]date last modifi i‡ ° d ONLN dâx ¢Ñ ¨ )Eed ° d ONLN dåx ”Ñ Ì )1(long) ° d ONLN dìx Ñï )9 (Seconds since January 1, 1904) ° d ONLN d¥à ]î ` (ë ]r E ° d ONLN dµà aî é )
eserved(4) ° d ONLN d¿à ”î Ì )r(long) ° d ONLN d…ò ]§ è (° ] entry count ° d ONLN d’ò ”§ Ì )v(long) ° d ONLN dfi® ]¥ ï (± ]list of entries . ° d ONLN d“ ]fi { **'dict ° d ONLN d“ {fi Ä ) ' , Symbol . ° d ONLN d “ “› € )WÆ ° d ONLN d “ fi8 )7
Dictionary ° d ONLN dP¸ ] ® ( ]entry byte length ° d ONLN db¸ – Ì )s(short) ° d ONLN dj¸n )7(Length is all-inclusive) ° d ONLN dÖ ] ä ( ]
entry type ° d ONLN dê – Ì )s(short) ° d ONLN dö ]( c (% ]fi å¿ ° d ONLN dú c( å ) eld count ° d ONLN d¶ –( Ì )m(short) ° d ONLN d∞, ]8 ~ (5 ] list of fi ¶@ ° d ONLN d∫, ~8 ê )!elds ° d ONLN d˜V ]b q (_ ]0x00 ’X ° d ONLN d¸V “a € )uÆ ’N ° d ONLN d˛Vb3 )3
Null entry ° d ONLN d
f ]r ì (o ] 0x01 to 0x20 ’X ° d ONLN df “q € )uÆ ’N ° d ONLN dfr- )3Reserved ° d ONLN d#v ]Ç q ( ]0x21 ’X ° d ONLN d(v “Å € )uÆ ’N ° d ONLN d*vÇ )3Pr £Ó ° d ONLN d,vÇ] )
onunciation entry ° d ONLN d?Ü ]í q (è ]0x22 ’X ° d ONLN dDÜ “ë € )uÆ ’N ° d ONLN dFÜí )3Abbr pŒ ° d ONLN dJÜ íY )eviation entry ˇ ◊# ˇ ˇˇˇˇ # ◊
° d ONLN d ; { G ò ( D {Each fi j ° d ONLN d ; ô G ) eld consists of the following: ° d ONLN d µ Ö { ë † ( é {The curr Í¿ ° d ONLN d Ω Ö † ë … )% ently defi ±¿ ° d ONLN d « Ö ë „ )*ned fi ı@ ° d ONLN d Õ Ö „ ë ) eld types ar b@ ° d ONLN d Ÿ Ö ë[ )4e the following:
9 4 9 {
ˇ·ˇ‚ˆA ° d ONLN d˜ {) ( {!Creating and Editing Dictionaries ˇˇˇˇˇˇ ‘@ ( 1
° d ONLN d {+ è (( {Ther ¿ ° d ONLN d ê+ ) e is no built-in support for cr @ ° d ONLN d= +∫ )~(eating and editing speech dictionaries. @ ° d ONLN de ª+¡ )≠Y ”¿ ° d ONLN df ¿+Ë ) ou can cr «@ ° d ONLN do Ë+¸ )(eate ° d ONLN dt, {8 Æ (5 { dictionary r ,¿ ° d ONLN dÄ, Ø8 « )4esour u ° d ONLN dÖ, «8N ) ces using any of the available r ı¿ ° d ONLN d•,N8f )áesour > ° d ONLN d™,g8˚ )!ce editing tools such as the MPW ° d ONLN dÀ9 {Eù (B {DRez tool or ResEdit. Of course, you can also fairly easily develop r † ° d ONLN d9ûE (Bûoutines to edit the ° d ONLN d#F {R ∂ (O {dictionary str ≈¿ ° d ONLN d1F ∂R Õ );uctur K† ° d ONLN d6F ŒR ‹ )e fr Æ ° d ONLN d:F ‹RS )om within the application. ∫` ° d ONLN dUFSRz )w At the pr hÄ ° d ONLN d^F{RÒ )(esent time, no assumption ° d ONLN dxS {_T (\ {2should be made that the entries in a dictionary ar r¿ ° d ONLN d™ST_l )Ÿe stor v@ ° d ONLN d∞Sl_¨ )ed in sorted or ú¿ ° d ONLN døS¨_∫ )@der ∑` ° d ONLN d¬S∫_º ).
} 9Ñ 4~ 9Ñ {
ˇ·ˇ‚ˆA ° d ONLN dƒp {~ ª (z {
Advanced V âÄ ° d ONLN dŒp ª~C )@oice Information Routines ˇˇˇˇˇˇ ‘@ (z 1
ˇˇÛä . ° d ONLN dÈÑ {ê á (ç {Or R` ° d ONLN dÎÑ áê Æ ) dinarily 6† ° d ONLN dÛÑ ≠êq )&-, an application should need to use only the ,
Courier ˇˇ⁄û Δz ° d ONLN d Ñqê„ )ƒGetVoiceDescription ˇˇÛä Δz ° d ONLN d3Ñ„êË )r r åd ° d ONLN d5ÑÈê )outine . ° d ONLN d<ë {ùÅ (ö {<to access information about a particular voice. Occasionally z† ° d ONLN dxëÄù´ (öÄ , however á@ ° d ONLN dÅë´ù€ )+ , it may be . ° d ONLN dçû {™ „ (ß {necessary to obtain mor R` ° d ONLN d§û „™Ñ )h$e detailed information by using the R` ° d ONLN d»ûљà )° GetVoiceInfo R` ° d ONLN d‘ûÙ“ )H r $¿ ° d ONLN d÷û“™Ò )outine.
⁄ 9„ 4€ 9‚ ‹ 9‹
ˇ·ˇ‚ˆA . ° d ONLN dfiÕ 9€ V (◊ 9GetV }Ä ° d ONLN d‚Õ U€ Ç ) oiceInfo ˇˇˇˇˇˇ (◊1
. ° d ONLN dÏÏ {¯ è (ı {The ° d ONLN dÏ è¯ ◊ ) GetVoiceInfo ° d ONLN d¸Ï ◊¯ › )H r R` ° d ONLN d˛Ï ›¯ ˇ )outine r $¿ ° d ONLN dÏ ˇ¯ï )"!eturns information about a specifi $¿ ° d ONLN d(Ïï¯ )ñed voice channel beyond ° d ONLN d@˘ { ‘ ( {that obtainable thr R` ° d ONLN dS˘ ‘ ˛ )Y ough the R` ° d ONLN d\˘ ˛p )*GetVoiceDescription R` ° d ONLN do˘pv )r r $¿ ° d ONLN dq˘vï )outine. ° d ONLN dy { … ( {pascal OSErr ° d ONLN dÜ … È )N0GetVoiceInfo (VoiceSpec *voice, OSType selector, ° d ONLN d∏ ç, ˘ () ç void *voiceInfo); ° d ONLN dÃ8 çDe *$typedef VoiceDescription *voiceInfo; ° d ONLN dÚF çRS *!typedef VoiceFileInfo *voiceInfo; ° d ONLN db çnA * typedef struct VoiceFileInfo { ° d ONLN d6p ç| ± *FSSpec ° d ONLN d?p √| ˘ )6 fileSpec; ° d ONLN dLp |Ô )H&// vol, dir, name info for voice file ° d ONLN dt~ çä ´ (á çshort ° d ONLN d|~ √ä Á )6resID; ° d ONLN dÜ~ ä„ )H$// resource ID of voice in the file ° d ONLN d´å {ò € (ï {} VoiceFileInfo; . ° d ONLN d % M { Y Å ( V {fi å¿ ° d ONLN d ' M Å Y √ )eld byte length *¨ ° d ONLN d 7 M Í Y )i(short) ˇ˘ ° d ONLN d ? M YŒ )6'(Length is all-inclusive minus padding) ° d ONLN d h ] { i Å ( f {fi å¿ ° d ONLN d j ] Å i § )eld type *¨ ° d ONLN d s ] Í i )i(short) ° d ONLN d } m { y Å ( v {fi å¿ ° d ONLN d m Å y § )eld data *¨ ° d ONLN d à m Í y
)i(char[]) ˇ˘ ° d ONLN d ë m yÜ )6(Data is padded to wor ·9 ° d ONLN d ß mÜ yΩ )f d boundary) ° d ONLN d È ó { £ è ( † {0x00 , Symbol Ä ° d ONLN d Ó ó Ë ¢ Ò )mÆ UM ° d ONLN d ó £; )7Null fi Õ ° d ONLN d ˜ ó< £I ) eld ° d ONLN d ¸ ß { ≥ ± ( ∞ { 0x01 to 0x20 Ä ° d ONLN d ß Ë ≤ Ò )mÆ UM ° d ONLN d ß ≥G )7Reserved ° d ONLN d ∑ { √ è ( ¿ {0x21 Ä ° d ONLN d ∑ Ë ¬ Ò )mÆ UM ° d ONLN d ∑ √) )7W jM ° d ONLN d ∑( √1 ) or §Õ ° d ONLN d ∑1 √= ) d r ç ° d ONLN d" ∑> √L )epr ñM ° d ONLN d% ∑L √º )esented in textual format. ° d ONLN dA « { ” è ( – {0x22 Ä ° d ONLN dF « Ë “ Ò )mÆ UM ° d ONLN dH « ”W )7 Phonemic pr ¥ç ° d ONLN dS «W ”¸ )8%onunciation including a complete set UM ° d ONLN dx “ fi{ ( € of syllable, lexical str U- ° d ONLN dê “{ fiü )\ess, wor *M ° d ONLN dò “ü fi± )$d pr ç- ° d ONLN dú “± fiÙ )ominence, and UM ° d ONLN d™ › È( ( Ê pr m ° d ONLN d¨ ›) Èr )
osodic markers r ÃÕ ° d ONLN dº ›r ÈÄ )Iepr ]ç ° d ONLN dø ›Å ÈÔ )esented in textual format ° d ONLN d⁄ Ì { ˘ è ( ˆ {0x23 Ä ° d ONLN dfl Ì Ë ¯ Ò )mÆ UM ° d ONLN d· Ì ˘v )7Part-of-speech code ˇ ◊# ˇ ˇˇˇˇ # ◊
. ° d ONLN d ; ] G Å ( D ]enum { ° d ONLN d I o U € +soVoiceDescription ° d ONLN d ! I Ì U# )~ = 'info', ° d ONLN d . I5 UÀ )H// gets basic voice info ° d ONLN d I W o c ± ( ` o soVoiceFile ° d ONLN d [ W Ì c )~= 'fref' ° d ONLN d g W5 c› )H // gets voice file ref info ° d ONLN d Ñ e ] q i ( n ]};
° d ONLN d" ‹ ] Ë‹ +BXThis function accepts selectors that determine the type of information you want to get. ° d ONLN dz È ] ı Á * The format of the information r µ@ ° d ONLN dô È Á ı‹ )ä7eturned depends on which value is used in the selector ° d ONLN d– ˆ ] c ( ˇ ]fi å¿ ° d ONLN d“ ˆ c § )eld, as follows:
. ° d ONLN dˆ ]' u *info . ° d ONLN d˚ π'[ )\%Gets basic information for the specifi @ ° d ONLN d!['£ )¢ed voice. The str ` ° d ONLN d2§'ª )Iuctur ç@ ° d ONLN d7ª'¬ )e ˇˇE¥ . ° d ONLN d9' π3 Ω (0 πr R` ° d ONLN d:' Ω3p )*eturned is functionally equivalent to the ˇ˝— Ùò ° d ONLN dd'p3– )≥VoiceDescription ˇˇE¥ Ùò ° d ONLN dt'–3Ë )` data ° d ONLN dz3 π? ≈ (< πstr l ° d ONLN d}3 ≈? € ) uctur >` ° d ONLN dÇ3 €? Ì )e in >` ° d ONLN dá3 Ì?_ )GetVoiceDescription >` ° d ONLN dö3_?” )r , described earlier in this . ° d ONLN d∂? πK (H π document. T o¿ ° d ONLN d¡? Kê )7#o maximize compatibility with futur ¿ ° d ONLN d‰?ëK€ )°e versions of the . ° d ONLN dˆK πW (T πSpeech Manager ¬† ° d ONLN dKWä )J , the application must set the ¬† ° d ONLN d#KäWÆ )álength ¬† ° d ONLN d)KÆW∑ )$ fi ¬† ° d ONLN d,K∑W ) eld of the ° d ONLN d7W πc (` πVoiceDescription ° d ONLN dGWc' )` str l ° d ONLN dKW'c= )uctur >` ° d ONLN dPW=cº ) e to the size of the existing r ¿ ° d ONLN doWºcŒ )ecor „ ° d ONLN dsWÕc’ )d ° d ONLN duc πo – (l πbefor R` ° d ONLN dzc –o ˘ )
e calling R` ° d ONLN dÑc ˘oA )) GetVoiceInfo R` ° d ONLN dêcAoÅ )H, which then r $¿ ° d ONLN dûcÅo· )@eturns the size of the . ° d ONLN dµo π{ “ (x πnew r ∑ ° d ONLN d∫o “{ ‰ )ecor +` ° d ONLN dæo Â{ Ì )d. . ° d ONLN d¡~ ]ä u (á ]fref . ° d ONLN dΔ~ πä ’ )\Gets fi ˆ‡ ° d ONLN dÕ~ ’ä „ ) le r ̇ ° d ONLN d—~ „ä Û )efer ö ° d ONLN d’~ Ùäm )ence information for specifi ‘` ° d ONLN dÒ~mä◊ )yed voice; normally only ° d ONLN d ä πñï (ì π2used by speech synthesizers to access voice disk fi d¿ ° d ONLN d<äññ± )›les dir ú‡ ° d ONLN dCä±ñ≈ )ectly t‡ ° d ONLN dHä≈ñ« ). ° d ONLN dJØ ∏ 5 (∂ RESUL ëÄ ° d ONLN dOØ 5∏ Y )T CODES
]V ( ]6This section describes how you can insert commands dir ›Ä ° d ONLN d#
V )˘ ectly into the input text to ° d ONLN d@ ]# s ( ]contr >Ä ° d ONLN dE t#* )'ol or modify the spoken output. When pr /` ° d ONLN dl*#∏ )∂!ocessing input text data, speech ° d ONLN dç$ ]0b (- ]=synthesizers look for special sequences of characters called
` ° d ONLN d $c0î (-c delimiters. - ° d ONLN d’$î0› )1 These character ° d ONLN dÊ1 ]= ï (: ] sequences ar }¿ ° d ONLN dÚ1 ï= – )8e usually defi ‰† ° d ONLN d 1 –=· );>ned to be unusual pairings of printable characters that would ° d ONLN d>> ]J÷ (G ]Snot normally appear in the text. When a begin command delimiter string is encounter B@ ° d ONLN dë>◊J‰ (G◊ed ° d ONLN dîK ]W (T ](in the text, the following characters ar @ ° d ONLN dºKWî )ß e assumed to contain one or mor 6Ä ° d ONLN d€KîW‰ )êe commands. The ° d ONLN dÎX ]d (a ](synthesizer will attempt to parse and pr ª ° d ONLN dXd⁄ )∞*ocess these commands until an end command ° d ONLN d=e ]q ⁄ (n ] delimiter string is encounter {† ° d ONLN dZe ⁄q Á )}ed. . ° d ONLN dVΩ ]… { (Δ ]noErr . ° d ONLN d\Ω ‘… Ÿ )w0 ° d ONLN d^Ω Ì… )No err E† ° d ONLN ddΩ
… ) or . ° d ONLN dh» ]‘ ô (— ]
memFullErr . ° d ONLN ds» ≈‘ Ÿ )h–108 ° d ONLN dx» Ì‘¿ )(+Not enough memory to load voice into memory . ° d ONLN d•” ]fl ´ (‹ ]voiceNotFound . ° d ONLN d≥” ≈fl Ÿ )h–244 ° d ONLN d∏” Ìfl Ù )(V ú` ° d ONLN dπ” Ûfl )oice r y ° d ONLN dø” fl# )esour ¡` ° d ONLN dƒ”#flZ ) ce not found ˇ9: ◊# ˇ ˇˇˇˇ # ◊
ˇ·ˇ‚ˆA ° d ONLN d ; { IC ( E { Embedded Speech Command Syntax ˇˇˇˇˇˇ ‘@ ( E 1
° d ONLN d O { [ï ( X {;By default, the begin command and end command delimiters ar @ ° d ONLN d [ Oñ [Æ ( Xñe defi V ° d ONLN d a OÆ [ )ned to be [[ and ]]. ° d ONLN d v \ { hx ( e {4The syntax of embedded command blocks is given below Ø` ° d ONLN d ™ \w hì )¸, accor ` ° d ONLN d ± \ì h“ ) ding to these r )Ä ° d ONLN d ¿ \” hÈ )@ules: , Zapf Dingbats ° d ONLN d « r { y Ä ( x {n
. ° d ONLN d … o á { ) "Items enclosed in angle brackets ( ,
Courier ° d ONLN d Î o {" )ï< ° d ONLN d Ï o" {7 ) and ° d ONLN d Ò o7 {= )> ° d ONLN d Ú o= {G )) r R` ° d ONLN d ı oG {V )
epr $¿ ° d ONLN d ¯ oV { )esent logical units that ar ˜ ° d ONLN d o… {Ô )s e either . ° d ONLN d { á á ó ( Ñ ádefi r ° d ONLN d { ò á ˇ )ned further below or ar y¿ ° d ONLN d7 { ˇ á» )g.e atomic units that should be self-explanatory ` ° d ONLN de {» áÕ )…. ° d ONLN dh ê { ó Ä ( ñ {n
. ° d ONLN dñ ü á ´ ) Items followed by an ellipsis ( ° d ONLN dµ ü ´ )â… ° d ONLN d∂ ü ´B )
) may be r R` ° d ONLN d¿ üB ´ñ ),epeated one or mor $¿ ° d ONLN d“ üñ ´ª )T e times. . ° d ONLN d‹ ¥ { ª Ä ( ∫ {n
. ° d ONLN dfi ± á Ω4 ) 'For items separated by a vertical bar ( ° d ONLN d ±4 Ω: )≠| ° d ONLN d ±: Ω˜ ),), any one of the listed items may be used. . ° d ONLN d3 Δ { Õ Ä ( Ã {n
° d ONLN dy ’ á · ) 4Multiple commands should be separated by semicolons. ° d ONLN dÆ Ê { Ú Ò ( Ô { All other characters that ar X¿ ° d ONLN d Ê Ò Úÿ )v3e not enclosed between angle brackets must be enter s@ ° d ONLN d˝ Êÿ Ú )Áed ° d ONLN d Û { ˇ ù ( ¸ { literally ìÄ ° d ONLN d Û ú ˇ µ )!. Ther @ ° d ONLN d Û ∂ ˇ˜ )Ie is no limit to the number of commands that can be included in a single ° d ONLN dX { ƒ ( {command block. ° d ONLN dø { å *Her ` ° d ONLN d¬ å 8 )$e is the embedded command syntax str Ä ° d ONLN dÊ9 P )≠uctur ü` ° d ONLN dÎP W )e: ° d ONLN dˇˇ (, {Identifi ˝‡ ° d ONLN dˇˇ ) e ˛∞ ° d ONLN dˇˇ )r ° d ONLN dˇˇ )FSyntax
° d ONLN d{3 {? ∫ (< { CommandBlock . ° d ONLN dà3 „? Í )h< . ° d ONLN dâ3 Í?( )BeginDelimiter . ∏¿ ° d ONLN dó3(?/ )>> ∏¿ ° d ONLN dò4/?5 )
∏¿ ° d ONLN dô35?< )< . ∏¿ ° d ONLN dö3<?u ) CommandList . @ ° d ONLN d•3u?| )9> @ ° d ONLN d¶4|?Ç )
@ ° d ONLN dß3Ç?â )< . @ ° d ONLN d®3â?¿ ) EndDelimiter . ~ ° d ONLN d¥3¡?» )8> . ° d ONLN d∑C {O π (L {BeginDelimiter . ° d ONLN dΔC „O Í )h< . ° d ONLN d«C ÍO )String1 . ù ° d ONLN dŒC O ) > ù ° d ONLN dœCO ) ù ° d ONLN d–CO )| ù ° d ONLN d—C O# ) ù ° d ONLN d“C#O* )< . ù ° d ONLN d”C*OI )String2 . ∫ ° d ONLN d⁄CIOP ) > . ° d ONLN d›S {_ ≤ (\ { EndDelimiter . ° d ONLN dÍS „_ Í )h< . ° d ONLN dÎS Í_ )String1 . ù ° d ONLN dÚS _ ) > ù ° d ONLN dÛS_ ) ù ° d ONLN dÙS_ )| ù ° d ONLN dıS _# ) ù ° d ONLN dˆS#_* )< . ù ° d ONLN d˜S*_I )String2 . ∫ ° d ONLN d˛SI_P ) > . ° d ONLN dc {o ∂ (l { CommandList . ° d ONLN dc „o Í )h< . ° d ONLN dc Ío )Command . )† ° d ONLN dco )*> )† ° d ONLN ddo! )
)† ° d ONLN dc!o/ )[; )† ° d ONLN dd/o5 )
)† ° d ONLN dc5o< )< . )† ° d ONLN d c<oe )Command . ”@ ° d ONLN d#ceoz ))>]… . ° d ONLN d(s { ß (| {Command . ° d ONLN d1s „ Í )h< . ° d ONLN d2s Í3 )CommandSelector . ‡ ° d ONLN dAs4; )J> ‡ ° d ONLN dBs;A ) ‡ ° d ONLN dCsAH )[ ‡ ° d ONLN dDsHN )P . ‡ ° d ONLN dEsNq )arameter . ã ° d ONLN dMsqx )#] ã ° d ONLN dNsx )… . ° d ONLN dQÉ {è ƒ (å {CommandSelector . ° d ONLN daÉ „è Í )h< . ° d ONLN dbÉ Íè ˝ )OST ° d ONLN deÉ ˝è
)ype . Í¿ ° d ONLN dhÉ
è )> . ° d ONLN dkì {ü § (ú { Parameter ˇˇ| . ° d ONLN duì „ü Í )h< ˇˇ–‹ . ° d ONLN dvì Íü ˝ )OST ° d ONLN dyì ˝ü
. ° d ONLN d⢠{ é ( {OST ° d ONLN då˘ é õ )ype . ° d ONLN dê˘ „ Í )U< ° d ONLN dë˘ Í\ ) character pattern (e.g., . ° d ONLN d¨˘\i )rRA ◊ ° d ONLN dÆ˘iu )TE . Ä ° d ONLN d∞˘v{ ), . Ä ° d ONLN d≤˘{ã )vers . π` ° d ONLN d∂˘ãê ), . π` ° d ONLN d∏˘ê¶ )aBcD . Ä ° d ONLN dº˘ß´ )) Ä ° d ONLN dΩ˘´≤ )> . ° d ONLN d¿ { ¢ ( { Character . ° d ONLN d „ Í )h< ° d ONLN dÀ Íá )!Any printable character (example . ° d ONLN dÏ áé )ùA . ∏ ° d ONLN dÌ éì ), . ∏ ° d ONLN dÔ ìó )b . Y ° d ONLN d òù ), . Y ° d ONLN dÚ ù† )* . <¿ ° d ONLN dÛ °¶ ), . <¿ ° d ONLN dı ¶¨ )# . L ° d ONLN dˆ ¨± ), . L ° d ONLN d¯ ±∂ )x . L ° d ONLN d˘ ∂∫ )) L ° d ONLN d˙ ∫¡ )> . ° d ONLN d˝ {% Æ (" { FixedPointV k ° d ONLN d Æ% æ )3alue . ° d ONLN d „% Í )5< ° d ONLN d Í%V )Decimal number: 0.0000 , Symbol ° d ONLN d%V$\ )l£ ° d ONLN d&\%^ ) . ° d ONLN d'^%e )N . G@ ° d ONLN d(f%h ) G@ ° d ONLN d)h$n )£ G@ ° d ONLN d*n%† ) 65535.9999 G@ ° d ONLN d5†%ß )2> . ° d ONLN d8) {5 ò (2 {32BitV 1† ° d ONLN d>) ò5 ® ) alue . ° d ONLN dC) „5 Í )K< . ° d ONLN dD) Í5 ˝ )OST ° d ONLN dG) ˝5
)ype . Í¿ ° d ONLN dJ)
5 )> . Í¿ ° d ONLN dK)5 ) . j¿ ° d ONLN dL)5 )| . j¿ ° d ONLN dM)5 ) . Í¿ ° d ONLN dN) 5$ )< . Í¿ ° d ONLN dO)$5D )LongInt . ∞ ° d ONLN dV)E5L )!> . ∞ ° d ONLN dW)L5N ) . 0 ° d ONLN dX)O5V )| . 0 ° d ONLN dY)V5X ) . ∞ ° d ONLN dZ)X5_ )< . ∞ ° d ONLN d[)_5ê )
HexLongInt . ` ° d ONLN de)ë5ò )2> . ° d ONLN dh9 {E ò (B {16BitV 1† ° d ONLN dn9 òE ® ) alue . ° d ONLN ds9 „E Í )K< . ° d ONLN dt9 ÍE )Integer . a¿ ° d ONLN d{9E ) > . a¿ ° d ONLN d|9E ) . ·¿ ° d ONLN d}9E )| . ·¿ ° d ONLN d~9E ) . a¿ ° d ONLN d9E! )< . a¿ ° d ONLN dÄ9!EN )
HexInteger . Ó` ° d ONLN dä9NEU )-> . ° d ONLN dçI {U ì (R {8BitV 1† ° d ONLN díI ìU £ )alue . ° d ONLN dóI „U Í )P< . ° d ONLN dòI ÍU ¸ )Byte . ”@ ° d ONLN dúI ¸U )> . ”@ ° d ONLN dùIU ) . S@ ° d ONLN dûIU )| . S@ ° d ONLN düIU ) . ”@ ° d ONLN d†IU )< . ”@ ° d ONLN d°IU8 )HexByte . —` ° d ONLN d®I9U@ )#> . ° d ONLN d´Y {e õ (b {LongInt . ° d ONLN d≥Y „e Í )h< ° d ONLN d¥Y Íe? )Decimal number: 0 ° d ONLN dΔY?dE )U£ ° d ONLN d«YEeG ) . ° d ONLN d»YGeN )N . G@ ° d ONLN d…YOeQ ) G@ ° d ONLN d YQdW )£ G@ ° d ONLN dÀYWeã ) 4294967295 G@ ° d ONLN d÷Yãeí )4> . ° d ONLN dŸi {u ¨ (r {
HexLongInt . ° d ONLN d‰i „u Í )h< ° d ONLN dÂi ÍuX )Hex number: 0x00000000 ° d ONLN d¸iXt^ )n£ ° d ONLN d˝i^u` ) . ° d ONLN d˛i`ug )N . G@ ° d ONLN dˇihuj ) G@ ° d ONLN d ijtp )£ G@ ° d ONLN dipu¨ ) 0xFFFFFFFF G@ ° d ONLN d i¨u≥ )<> . ° d ONLN dy {Ö ó (Ç {Integer . ° d ONLN dy „Ö Í )h< ° d ONLN dy ÍÖ? )Decimal number: 0 ° d ONLN d*y?ÑE )U£ ° d ONLN d+yEÖG ) . ° d ONLN d,yGÖN )N . G@ ° d ONLN d-yOÖQ ) G@ ° d ONLN d.yQÑW )£ G@ ° d ONLN d/yWÖr ) 65535 G@ ° d ONLN d5yrÖy )> . ° d ONLN d9âØï› += (continued) ˇ
ˇ·ˇ‚ˆA ° d ONLN d Ñ ] í ( é ]Embedded Speech Command Set ˇˇˇˇˇˇ ‘@ ( é‚1
° d ONLN d ò ] § c ( ° ]T µ¿ ° d ONLN d ò b § Ñ )able 1-1 √@ ° d ONLN d & ò Ñ § È )" outlines the set of curr …¿ ° d ONLN d ? ò È § )e ently defi ê¿ ° d ONLN d I ò §´ )* ned embedded speech commands. ° d ONLN dˇˇ ( X ]
HexInteger ,
Courier . ° d ONLN dˇˇ )h< ° d ONLN dˇˇ )Hex number: 0x0000 , Symbol ° d ONLN dˇˇ )Z£ ° d ONLN dˇˇ ) . ° d ONLN dˇˇ )N . G@ ° d ONLN dˇˇ ) G@ ° d ONLN dˇˇ )£ G@ ° d ONLN dˇˇ ) 0xFFFF G@ ° d ONLN dˇˇ )$> . ° d ONLN dˇˇ ( h ]Byte . ° d ONLN dˇˇ )h< ° d ONLN dˇˇ )Decimal number: 0 ° d ONLN dˇˇ )U£ ° d ONLN dˇˇ ) . ° d ONLN dˇˇ )N . G@ ° d ONLN dˇˇ ) G@ ° d ONLN dˇˇ )£ G@ ° d ONLN dˇˇ ) 255 G@ ° d ONLN dˇˇ )> . ° d ONLN dˇˇ ( x ]HexByte . ° d ONLN dˇˇ )h< ° d ONLN dˇˇ )Hex number: 0x00 ° d ONLN dˇˇ )P£ ° d ONLN dˇˇ ) . ° d ONLN dˇˇ )N . G@ ° d ONLN dˇˇ ) G@ ° d ONLN dˇˇ )£ G@ ° d ONLN dˇˇ ) 0xFF G@ ° d ONLN dˇˇ )>
« œÈ 4 » œÈ À ] ÀÈ
ˇ·ˇ‚ˆA . ° d ONLN d g Ω ] » Ñ ( ≈ ] Table 1-1 ° d ONLN d q Ω õ » )>Embedded speech commands p ° d ONLN dˇˇ )z ° d ONLN dˇˇ ( › _Command ° d ONLN dˇˇ +oSelecto
Å` ° d ONLN dˇˇ ) r ° d ONLN dˇˇ ( › Command syntax and description
° d ONLN d Δ Á ] Û d ( ]V ú` ° d ONLN d « Á c Û ~ )ersion . ° d ONLN d Œ Á Œ Û Ê )kvers ° d ONLN d ” Á Û- );vers < . ° d ONLN d Ÿ Á- Û4 )$V Õ ° d ONLN d ⁄ Á3 ÛK )ersion . >† ° d ONLN d ‡ ÁL ÛR )> . ° d ONLN d ‚ Ú ˛ ( ˚ V Õ ° d ONLN d „ Ú ˛' )ersion . >† ° d ONLN d È Ú( ˛F )::= < . >† ° d ONLN d Ó ÚF ˛c ) 32BitV @ ° d ONLN d Ù Úb ˛r ) alue . öÄ ° d ONLN d ¯ Ús ˛y )> . ° d ONLN d ˙ ˝ ” ( ,This command informs the synthesizer of the ° d ONLN d& ÿ * /format version that will be used in subsequent ° d ONLN dU œ * *commands. This command is optional but is ° d ONLN d *, * highly r V¿ ° d ONLN dá ,*í )#ecommended. The curr µ ° d ONLN dõ í*÷ )fent version is 1. ° d ONLN dÆ0 ]< á (9 ] Delimiter . ° d ONLN d∏0 Œ< Ê )qdlim ° d ONLN dΩ0 <- );dlim < . ° d ONLN d√0-<k )$BeginDelimiter . ∏¿ ° d ONLN d—0k<} )>> < . ∏¿ ° d ONLN d‘0}<¥ ) EndDelimiter . F† ° d ONLN d‡0µ<ª )8> . ° d ONLN d‚; Gí (D The delimiter command specifi ‡ ° d ONLN dˇ;ìG⁄ )äes the character ° d ONLN dF R‰ (O 1sequences that mark the beginning and end of all ° d ONLN dAQ ]‡ * -subsequent commands. The new delimiters take ° d ONLN dn\ h * ef o‡ ° d ONLN dp\h )fect at the end of the curr Ï@ ° d ONLN dã\h‰ )nent command block. If ° d ONLN d°g sm (p the delimiter strings ar ` ° d ONLN dπgnsë )ee empty ™Ä ° d ONLN d¿gêsØ )", an err } ° d ONLN d»gØsƒ ) or is ˇˇ∂⁄ . ° d ONLN dŒr ~“ ({ ,generated. (Contrast this behavior with the ˇˇ$é … ° d ONLN d˙r“~Í )…dlim ˇˇ∂⁄ … ° d ONLN d˛rÍ~Î ) ° d ONLN dˇ} â: (Ü function of ° d ONLN d }:âà )1SetSpeechInfo ° d ONLN d}àâè )N.) . ° d ONLN d è ]õ â (ò ]Comment . ° d ONLN d$è Œõ Ê )qcmnt ° d ONLN d)è õ- );cmnt [ . ° d ONLN d/è-õT )$ Character . † ° d ONLN d8èUõa )(]… . ° d ONLN d;ö ¶’ (£ -This command enables a developer to insert a ° d ONLN dh• ±n * comment into a text str ° d ONLN d•o±Ÿ )feam for documentation ° d ONLN dï∞ º› (π 1purposes. Note that all characters following the . ° d ONLN dΔª «! * cmnt ° d ONLN d ª!«y ) selector up to the < . ° d ONLN dflªy«∞ )X EndDelimiter . ‡ ° d ONLN dΪ±«ƒ )8> ar ‡@ ° d ONLN dÔª√«Î )
e part of . ° d ONLN d˘Δ “E (œ the comment. ° d ONLN dÿ ]‰ t (· ]Reset . ° d ONLN dÿ Œ‰ Ê )qrset ° d ONLN dÿ ‰- );rset < . ° d ONLN dÿ-‰J )$32BitV 1† ° d ONLN d ÿJ‰Z ) alue . €‡ ° d ONLN d"ÿZ‰` )> . ° d ONLN d$„ Ô (Ï The r Ä¿ ° d ONLN d)„ Ôz )eset command will r c` ° d ONLN d<„zÔÍ )Zeset the speech channel’s ° d ONLN dVÓ ˙Á (˜ 3settings back to the default values. The parameter ° d ONLN d⢠X * should be set to 0. ° d ONLN d† Ø› +¶ (continued) ° d ONLN dˇˇ ( H ]Identifi ˝‡ ° d ONLN dˇˇ ) e ˛∞ ° d ONLN dˇˇ )r ° d ONLN dˇˇ )FSyntax ˇ¿ ◊# ˇ ˇˇˇˇ # ◊
° d ONLN d- »' ‘í ( —'If the pitch number is pr € ° d ONLN dF »í ‘‰ )keceded by a + or – ° d ONLN dY ”' flO ( ‹' character e¿ ° d ONLN db ”O flŸ )(", the baseline pitch is adjusted r Ù` ° d ONLN dÑ ”Ÿ fl )ä elative to ° d ONLN dè fi' ÍF ( Á'its curr ñ¿ ° d ONLN dó fiF Í¥ ) ent value. Pitch values ar *‡ ° d ONLN d± fiµ Í )oe always positive ° d ONLN d√ È' ı∏ ( Ú'"numbers. For further details, see H ° d ONLN d Èπ ı )í“SetSpeechInfo,” #¿ ° d ONLN dı È ı )K ° d ONLN dˆ Ù' í ( ˝'earlier in this document. ° d ONLN d { « ( {Pitch modulation . ° d ONLN d" Ï )qpmod ° d ONLN d''{ );pmod [+ | -] < . ° d ONLN d5{√ )TModulationDepth . @` ° d ONLN dDƒ )I> . ° d ONLN dF' o ('ModulationDepth . @` ° d ONLN dUp î )I ::= < . @` ° d ONLN d[î « )$ FixedPointV +` ° d ONLN df« ◊ )3alue . ’† ° d ONLN dj◊ › )> . ° d ONLN dl '(Ó (%')The pitch modulation command changes the ° d ONLN dï''3Û * -modulation range for the speech channel. The ° d ONLN d¬2'>è * modulation value is a fi ◊‡ ° d ONLN d⁄2è>˝ )hxed-point number in the ° d ONLN dÚ='I^ (F'range 0.0 thr ıÄ ° d ONLN dˇ=^IÎ )7 ough 100.0 that conforms to the ° d ONLN d H'Tá (Q'following pitch and fr $ ° d ONLN d5HàT≥ )a equency r m@ ° d ONLN d>H≥TÍ )+elationships: . ° d ONLN dM^'jy (g'Maximum pitch = ° d ONLN d]^yjØ )R BasePitch ° d ONLN df^Øjπ )6 + ° d ONLN di^πjÈ )
PitchMod ° d ONLN dri'uw (r'Minimum pitch = ° d ONLN dÇiwu≠ )P BasePitch ° d ONLN dãi≠uµ )6 - ° d ONLN déiµu )PitchMod ° d ONLN dót'Ä{ (}'Maximum Hertz = ° d ONLN dßt{ı )T BaseHertz ° d ONLN d∞t±Äø )6 * 2 . ° d ONLN d¥rø{» (yø(+ . ° d ONLN d∑s…{Ò )
ModValue . ° d ONLN dørÒ{ )( / 12)
. ° d ONLN dΔ'ãy (à'Minimum Hertz = ° d ONLN d÷yãØ )R BaseHertz ° d ONLN dflØãΩ )6 * 2 . ° d ONLN d„}ΩÜ≈ (ÑΩ(– . * ° d ONLN dÊ~ΔÜÓ ) ModValue . * ° d ONLN dÓ}ÓÜ )( / 12)
D ) ,ds per minute on the speech channel. If the ° d ONLN d‹'!h ( 'rate value is pr JÄ ° d ONLN dÏi!‰ )B eceded by a + or – character √ ° d ONLN d„!¯ )z, the ° d ONLN d ',ö ()'speaking rate is adjusted r ( ° d ONLN d) õ, )telative to its curr C` ° d ONLN d< Â,ı )Jent ° d ONLN d@+'7A (4'value. ™ ° d ONLN dJ=€I +¥ (continued)
F 9 M 4 F 9 M I { I
ˇ·ˇ‚ˆA ° d ONLN dˇˇ ( C { Table 1-1 ° d ONLN dˇˇ )>Embedded speech commands p ° d ONLN dˇˇ )z (continued) ° d ONLN dˇˇ ( [ }Command ° d ONLN dˇˇ +oSelecto
Å` ° d ONLN dˇˇ ) r ° d ONLN dˇˇ ( [' Command syntax and description ˇÊ ◊# ˇ ˇˇˇˇ # ◊
° d ONLN d e ] q d ( n ]V ú` ° d ONLN d e c q )olume ,
Courier . ° d ONLN d e Œ q Ê )kvolm ° d ONLN d e q] );volm [+ | -] < . ° d ONLN d e] qd )TV ˙¿ ° d ONLN d ec q{ )olume . l@ ° d ONLN d e| qÇ )> . ° d ONLN d " p | ( y V ˙¿ ° d ONLN d # p |' )olume . l@ ° d ONLN d ( p( |F )::= < . l@ ° d ONLN d - pF |y ) FixedPointV W@ ° d ONLN d 8 py |â )3alue . Ä ° d ONLN d < pä |ê )> . ° d ONLN d > { á– ( Ñ (The volume command changes the speaking ° d ONLN d f Ü íö * volume on the speech channel. V ‡ ° d ONLN d Ö Üö í≈ )ë olumes ar òÄ ° d ONLN d é Ü≈ íà )+e ° d ONLN d ê ë ù ( ö expr 9` ° d ONLN d î ë ùH )
Input mode . ° d ONLN dÜe Œq Ê )qinpt ° d ONLN dãe q• );inpt TX | TEXT | PH | PHON . ° d ONLN d¶p |™ * "This command switches the input pr C@ ° d ONLN d»p´|“ )¢ ocessing ° d ONLN d—{ áË (Ñ /mode to either normal text mode or raw phoneme ° d ONLN d Ü í$ * mode. ° d ONLN dò ]§ £ (° ]Character mode . ° d ONLN dò Œ§ Ê )qchar ° d ONLN dò §i );char NORM | LTRL . ° d ONLN d,£ Ø« * 'The character mode command sets the wor }Ä ° d ONLN dS£«Øœ )æd ° d ONLN dUÆ ∫Ω (∑ 'speaking mode of the speech synthesizer iÄ ° d ONLN d|ÆΩ∫fi )¥. When ˇ˛Ä . ° d ONLN dÉπ ≈! (¬ NORM ˇˇÄ ° d ONLN dáπ!≈Ï )/ mode is selected, the synthesizer attempts to . ° d ONLN d∂ƒ –} (Õ automatically convert wor ˚` ° d ONLN dœƒ}–‡ )tds into speech. This is ° d ONLN dÁœ €Õ (ÿ .the most basic function of the text-to-speech . ° d ONLN d⁄ Ê> * synthesizer ¬† ° d ONLN d ⁄=Ê` )4. When ¬† ° d ONLN d'⁄`Êx )#LTRL d@ ° d ONLN d+⁄xÊ⁄ ) mode is selected, the . ° d ONLN dB Òã (Ó synthesizer speaks every wor ~ ° d ONLN d^ÂãÒπ )Ç d, number Ç ° d ONLN dgÂ∏Ò– )-, and ° d ONLN dm ¸j (˘ symbol letter by letter ≈ ° d ONLN dÑi¸œ )`. Embedded command ° d ONLN dó˚ ( pr G ° d ONLN dô˚√ )
'ocessing continues to function normally í ° d ONLN d¿˚¬« )Ø, ° d ONLN d¬ / ( however å† ° d ONLN d…/1 )&. ° d ONLN dà ]$ û (! ] Number mode . ° d ONLN dÿ Œ$ Ê )qnmbr ° d ONLN d› $i );nmbr NORM | LTRL . ° d ONLN dÓ# /’ * (The number mode command sets the number ° d ONLN d. :Ω * 'speaking mode of the speech synthesizer iÄ ° d ONLN d=.Ω:fi )¥. When ˇ˛Ä . ° d ONLN dD9 E! (B NORM ˇˇÄ ° d ONLN dH9!EÏ )/ mode is selected, the synthesizer attempts to . ° d ONLN dwD P∑ (M 'automatically speak numeric strings as . ° d ONLN dûO [ö * intelligently as possible. When ° d ONLN dæOö[≤ )ëLTRL !† ° d ONLN d¬O≤[ÿ ) mode is . ° d ONLN dÀZ fÅ (c selected, numeric strings ar N‡ ° d ONLN dÁZÇfÁ )ye spoken digit by digit. ™ ° d ONLN dlΩxÎ +; (continued)
F MÈ 4 F MÈ I ] IÈ
ˇ·ˇ‚ˆA ° d ONLN dˇˇ ( C ] Table 1-1 ° d ONLN dˇˇ )>Embedded speech commands p ° d ONLN dˇˇ )z (continued) ° d ONLN dˇˇ ( [ _Command ° d ONLN dˇˇ +oSelecto
Å` ° d ONLN dˇˇ ) r ° d ONLN dˇˇ ( [ Command syntax and description ˇ 4 ◊# ˇ ˇˇˇˇ # ◊
ˇ·ˇ‚ˆA
4ˇ¸ 9 ; , Helvetica ˇˇ—Ú . ˇÆ +{ The Speech Manager 4π {Ÿ (ø {)Summary of Phonemes and Prosodic Controls , Palatino
° d ONLN d X {d“ (a {JSynthesizers often support embedded commands that extend the set given in ”‡ ° d ONLN dhX“dÿ (a“T † ° d ONLN diXÿd˙ )able 1-1 ° d ONLN dqX˙dˇ )".
° d ONLN dùâ {ï& (í {!While embedded speech commands ar à` ° d ONLN dæâ&ïR )´
e being pr ≥@ ° d ONLN d»âRïÕ ), ocessed, several types of err ∏` ° d ONLN dÂâÕïˇ ){ ors may be ° d ONLN dñ {¢ ∫ (ü {detected and r ªÄ ° d ONLN d˛ñ ∫¢§ )?6eported to your application. If you have set up an err ®Ä ° d ONLN d4ñ§¢˚ )Íor callback handler ˇˇ ( . ° d ONLN dH£ {Ø § (¨ { with the ,
Courier ˇ˝Zx ºP ° d ONLN dQ£ §Ø ˛ ))soErrorCallBack ˇˇ ( ºP ° d ONLN d`£ ˛Ø> )Z selector of the ˇ˝Zx 4 ° d ONLN dq£?Øç )ASetSpeechInfo ˇˇ ( 4 ° d ONLN d~£çØí )N r %x ° d ONLN dÄ£íØ ) outine (described earlier), . ° d ONLN dú∞ {º Δ (π {you will be notifi ÎÄ ° d ONLN dÆ∞ Δº! )Ked once for every err J ° d ONLN d√∞"ºÌ )\0or that is detected. If you have not enabled err ±` ° d ONLN dÛ∞̺¯ )Àor ° d ONLN dˆΩ {…n (Δ {9callbacks, you can still obtain information about the err ‰¿ ° d ONLN d/Ωn…™ )Ûors encounter 4 ° d ONLN d<Ω´…Ê )=ed by calling . ° d ONLN dJ {÷ … (” {GetSpeechInfo ° d ONLN dW …÷ ˆ )N
with the ° d ONLN da ˆ÷& )-soErrors ° d ONLN di &÷∫ )0# selector (also described earlier). ° d ONLN då ∫÷˛ )î The following . ° d ONLN dõ◊ {„ á (‡ {err @ ° d ONLN dû◊ à„ ° )ors ar Î` ° d ONLN d§◊ †„ ˙ )e detected during pr „‡ ° d ONLN d∏◊ ˙„≤ )Z%ocessing of embedded speech commands:
° d ONLN dtx {ÑH (Å {+This section summarizes the phonemes and pr û ° d ONLN düxHÑ~ )Õ osodic contr x‡ ° d ONLN d´x~Ñ≤ )6 ols used by u† ° d ONLN d∑x≤Ñ )4American English ° d ONLN d»Ö {ë ‘ (é {speech synthesizers. ° d ONLN d e { q ô ( n {Silence . ° d ONLN d e Ï q )qslnc ° d ONLN d e' qK );slnc < . ° d ONLN d eK q~ )$ Milliseconds . …` ° d ONLN d e~ qÑ )3> . ° d ONLN d ! p' |Z ( y' Milliseconds . …` ° d ONLN d - pZ |~ )3 ::= < . …` ° d ONLN d 3 p~ |õ )$32BitV { ° d ONLN d 9 põ |´ ) alue . %@ ° d ONLN d = p¨ |≤ )> . ° d ONLN d ? {' ᢠ( Ñ'.The silence command causes the synthesizer to ° d ONLN d m Ü' í´ * generate silence for the specifi \Ä ° d ONLN d ç ܨ íˇ )Öed amount of time. ° d ONLN d ° ò { § ¶ ( ° {Emphasis . ° d ONLN d ™ ò Ï § )qemph ° d ONLN d Ø ò' §c );
emph + | - . ° d ONLN d ∫ £' ØÏ * (The emphasis command causes the next wor ∫ ° d ONLN d ‚ £Ï Øˇ )≈d to ° d ONLN d Á Æ' ∫í ( ∑'be spoken with either gr Ÿ@ ° d ONLN d ˇ Æí ∫ı )keater emphasis or less ° d ONLN d π' ≈ ( ¬'.emphasis than would normally be used. Using + ° d ONLN dD ƒ' –G * will for ûÄ ° d ONLN dL ƒG –˛ ) )ce added emphasis, while using – will for ∑ ° d ONLN du ƒ˛ – )∑ce ° d ONLN dx œ' €* ( ÿ'r E ° d ONLN dy œ+ €z )educed emphasis. ° d ONLN dã · { Ì Æ ( Í { Synthesizer ±† ° d ONLN dñ · Æ Ì Œ )3-Specifi v` ° d ONLN dû · œ Ì ” )!c . ° d ONLN d† · Ï Ì ) xtnd ° d ONLN d• ·' ÌK );xtnd < . ° d ONLN d´ ·K Ìn )$SynthCr S† ° d ONLN d≤ ·n ÌÅ )#eator . O@ ° d ONLN d∑ ·Ç Ìî )> [ . O@ ° d ONLN d∫ ·î ̺ ) parameter . Ÿ` ° d ONLN d√ ·º ̬ )(] . ° d ONLN d≈ Ï' ¯J ( ı'SynthCr S† ° d ONLN dà ÏJ ¯] )#eator . O@ ° d ONLN d— Ï^ ¯Ç ) ::= < . O@ ° d ONLN d◊ ÏÇ ¯ï )$OST ÷` ° d ONLN d⁄ Ïî ¯° )ype . ∫ ° d ONLN d› Ï¢ ¯® )> . ° d ONLN dfl ˜'π ( ' The extension command enables ° d ONLN d˝'Y * synthesizer Ƈ ° d ONLN dYx )2-specifi p‡ ° d ONLN dy ) c commands to be embedded in ° d ONLN d-'p ('the input text str û ° d ONLN d?pÏ )I eam. The format of the data ° d ONLN d['$T (!'
following ØÄ ° d ONLN deT$w )-SynthCr É ° d ONLN dlw$ä )#eator ~¿ ° d ONLN dqã$´ ) is entir .‡ ° d ONLN dz¨$˚ )!ely dependent on ° d ONLN dã#'/‡ (,',the synthesizer being used. If a particular ° d ONLN d∑.':J * SynthCr S† ° d ONLN dæ.J:] )#eator O@ ° d ONLN d√.^: ) is not r B‡ ° d ONLN dÃ.:˛ )! ecognized by the synthesizer 3¿ ° d ONLN dË.˛: ), ° d ONLN dÍ9'Eá (B'the command is ignor ° d ONLN d˛9àE¡ )aed but no err ˇ† ° d ONLN d 9¿E )8or is generated. . ° d ONLN d›Á {Û ∑ ( {
badParmVal . ° d ONLN dËÁ „Û ˜ )h–245 ° d ONLN dÌÁ Û~ )(Parameter value is invalid . ° d ONLN d Ú {˛ ∑ (˚ {
badCmdText . ° d ONLN dÚ „˛ ˜ )h–246 ° d ONLN dÚ ˛“ )('Embedded command syntax or parameter pr °Ä ° d ONLN d@Ú“˛Ì )«oblem . ° d ONLN dG˝ { ± ( { unimplCmd . ° d ONLN dQ˝ „ ˜ )h–247 ° d ONLN dV˝ )(2Embedded command is not implemented on synthesizer . ° d ONLN dä { ± ( { unimplMsg . ° d ONLN dî „ ˜ )h–248 ° d ONLN dô ÷ )(,Raw phoneme text contains invalid characters . ° d ONLN d« { ∑ ( {
ˇ·ˇ‚ˆA ° d ONLN d ; J o ( F Phoneme Set ˇˇˇˇˇˇ ∑† ( F·1
° d ONLN d Q ] ] c ( Z ]T µ¿ ° d ONLN d Q b ] Ñ )able 1-2 √@ ° d ONLN d Q Ñ ]
)" summarizes the set of standar 2@ ° d ONLN d 4 Q ]G )á d phonemes r —† ° d ONLN d @ QG ]É )<ecognized by g† ° d ONLN d M QÑ ]’ )=American English ° d ONLN d ^ ^ ] j ∂ ( g ]speech synthesizers. ° d ONLN d s p ] | *.In this description, it is assumed that specifi @ ° d ONLN d ¢ p |) )¬c r Ë ° d ONLN d • p) |ÿ )
° d ONLN d : ø { À( *%The “silence” phoneme (%) and the “br ƒ‡ ° d ONLN d _ ø( À° )≠eath” phoneme (@) may be ° d ONLN d x À { ◊U ( ‘ {/lengthened or shortened like any other phoneme. , Zapf Dingbats ô ° d ONLN d ® ŒZ ÷` )flu
9 4 9 9
ˇ·ˇ‚ˆA ° d ONLN d ™ ¯ 9 ß ( 9Prosodic Controls ˇˇˇˇˇˇ ∑† (ˇ1
° d ONLN d Ω { € ( {The symbols listed in ̆ ° d ONLN d ” € · )`T #` ° d ONLN d ‘ · )able 1-3 0‡ ° d ONLN d ‹ )" ar u‡ ° d ONLN d fl ) e r ÑÄ ° d ONLN d ‚q ) ecognized as modifi ˘Ä ° d ONLN d ıq‰ )Xers to the basic phonemes ° d ONLN d {' Õ ($ {described in the pr 8‡ ° d ONLN d" Œ' )Seceding section. âÄ ° d ONLN d2'Ç )F They can be used to mor W ° d ONLN dJÉ'î )oe pr g‡ ° d ONLN dNî'À )ecisely contr F¿ ° d ONLN d[À'Ê )7ol the ° d ONLN db( {4â (1 {=quality of speech that is described in terms of raw phonemes. §ó ° d ONLN dˇˇ ( j@y z ° d ONLN dˇˇ )?y
J ° d ONLN dˇˇ )et sœ ° d ONLN dˇˇ )K39 ° d ONLN d s 9 A ( | 9% ∞Ω ° d ONLN d s x ï )?silence ºÏ ° d ONLN d
s ƒ … )L0 §ó ° d ONLN d s@ E )|z z ° d ONLN d t É )?z
ûz ° d ONLN d sÉ ç )en sœ ° d ONLN d sœ Ÿ )L40 ° d ONLN d Ö 9 ë @ ( é 9@ ∞Ω ° d ONLN d Ö x ë Å )?br ˝] ° d ONLN d Ö Å ë ñ ) eath ∞Ω ° d ONLN d ê x ú ì ( ô xintake ºÏ ° d ONLN d & Ö ƒ ë … ( é ƒ1 §ó ° d ONLN d ( Ö@ ëF )|Z z ° d ONLN d * Ü ëÑ )?g
ù⁄ ° d ONLN d + ÖÑ ëó )enre sœ ° d ONLN d 0 Öœ ëŸ )K41
W 9_ 4X 9_ [ {[
ˇ·ˇ‚ˆA ° d ONLN d†M {X ¢ (U { Table 1-3
° d ONLN d™L πX ¬ )>Pr N† ° d ONLN d¨L √X ˘ )
osodic contr )Ä ° d ONLN d∏L ˘X( )6
ol symbols ° d ONLN dˇˇ )/ ° d ONLN dΔe 9p > (m 9T T ° d ONLN dœe >p M )ype ’U ° d ONLN d”e •p ≈ )gSymbol UV ° d ONLN d€e>pî )ôDescription of effect ° d ONLN dÛw 9Ç r ( 9Lexical stress:
. ° d ONLN d ; 9 G ] ( D 9enum { ° d ONLN d ; G≠ )ÿ// GetVoiceInfo selectors ° d ONLN d . I K U ∑ ( R KsoVoiceDescription ° d ONLN d G I … U ˇ )~ = 'info', ° d ONLN d T I Uß )H// gets basic voice info ° d ONLN d o W K c ç ( ` K soVoiceFile ° d ONLN d Å W … c ˘ )~= 'fref' ° d ONLN d ç W cπ )H // gets voice file ref info ° d ONLN d ™ e 9 q E ( n 9}; ° d ONLN d ≠ s 9 *#enum {kNeuter = 0, kMale, kFemale}; ° d ONLN d ‹ s › )ÿ"// returned in gender field below
± 9 ∏ 4 ± 9 ∏ ≤ 9 ≤
ˇ·ˇ‚ˆA . ° d ONLN d ˇ ¢ 9 ± Z ( ≠ 9Data ≥¿ ° d ONLN d ¢ Z ± b )!T | ° d ONLN d ¢ b ± )ypes ˇˇˇˇˇˇ ∑† ( ≠ˇ1
synthType; ° d ONLN dv Û'Y )~// always 'ttsc' ° d ONLN dâ) -5 Q (2 -OSType ° d ONLN dì) u5 √ )HsynthSubType; ° d ONLN dß) Û5S )~// synth flavor ° d ONLN dπ7 -C Q (@ -OSType ° d ONLN d√7 uC · )HsynthManufacturer; ° d ONLN d‹7 ÛCk )~// synth creator ID ° d ONLN dÚE -Q E (N -long ° d ONLN d˙E uQ ∑ )H synthFlags; ° d ONLN d E ÛQ} )~// synth feature flags ° d ONLN d%S -_ i (\ -
NumVersion ° d ONLN d3S u_ √ )HsynthVersion; ° d ONLN dGS Û_É )~// synth version number ° d ONLN d`a m ì (j } SpeechVersionInfo; ° d ONLN duz Ü √ * typedef struct PhonemeInfo { ° d ONLN dìà -î K +short ° d ONLN dõà cî ç )6opcode; ° d ONLN dßà ΩîY )Z// opcode for the phoneme ° d ONLN d√ñ -¢ K (ü -Str15 ° d ONLN dÀñ c¢ á )6phStr; ° d ONLN d÷ñ Ω¢k )Z // corresponding char string ° d ONLN dı§ -∞ K (≠ -Str31 ° d ONLN d˝§ c∞ • )6 exampleStr; ° d ONLN d§ Ω∞â )Z"// word that shows use of phoneme ° d ONLN d1≤ -æ K (ª -short ° d ONLN d9≤ cæ ´ )6 hiliteStart; ° d ONLN dJ≤ Ωæ} )Z // segment of example word that ° d ONLN dl¿ -à K (… -short ° d ONLN dt¿ cà ü )6
. ° d ONLN d ; 9 G Ì ( D 9 typedef struct DelimiterInfo { ° d ONLN d I K U c +Byte ° d ONLN d ' I Å U Ì )6startDelimiter[2]; ° d ONLN d @ I ˇ Uk )~// defaults to [[ ° d ONLN d T W K c c ( ` KByte ° d ONLN d [ W Å c · )6endDelimiter[2]; ° d ONLN d r W ˇ ck )~// defaults to ]] ° d ONLN d Ö e 9 q ô ( n 9} DelimiterInfo;
£ 9 ™ 4 £ 9 ™ § 9 §
ˇ·ˇ‚ˆA . ° d ONLN d ñ î 9 £ B *1V † ° d ONLN d ó î B £ ñ ) oice Routines ˇˇˇˇˇˇ ∑† ( üˇ1
. ° d ONLN d ¶ µ 9 ¡Ô ( æ 9Ipascal OSErr MakeVoiceSpec (OSType creator, OSType id, VoiceSpec *voice); ° d ONLN d √ 9 œA *,pascal OSErr CountVoices (short *numVoices); ° d ONLN d — 9 ›è *9pascal OSErr GetIndVoice (short index, VoiceSpec *voice); ° d ONLN dW fl 9 Î˚ *Kpascal OSErr GetVoiceDescription (VoiceSpec *voice, VoiceDescription *info, ° d ONLN d§ Ì K ˘ ∑ + long infoLength); ° d ONLN d∑ ˚ 9≈ ( 9Bpascal OSErr GetVoiceInfo (VoiceSpec *voice, OSType selector, void ° d ONLN d˚ K ô + *voiceInfo);
G 9N 4G 9N H 9H
ˇ·ˇ‚ˆA . ° d ONLN d 8 9G8 (C 9%Routines for Managing Speech Channels ˇˇˇˇˇˇ ∑† (Cˇ1
ˇ·ˇ‚ˆA ° d ONLN d ; 9 J ≤ ( F 9Error Return Codes ˇˇˇˇˇˇ ∑† ( Fˇ1 ,
Courier
. ° d ONLN d Q 9 ] W ( Z 9noErr . ° d ONLN d Q Ÿ ] fi )†0 ° d ONLN d Q Ú ] )No err E† ° d ONLN d Q ] ) or . ° d ONLN d $ ] 9 i i ( f 9paramErr . ° d ONLN d - ] œ i fi )ñ–50 ° d ONLN d 1 ] Ú i. )#Parameter err ¿ ° d ONLN d > ]/ i8 )=or . ° d ONLN d B h 9 t u ( q 9
memFullErr . ° d ONLN d M h t fi )ë–108 ° d ONLN d R h Ú tv )(Not enough memory to speak . ° d ONLN d n t 9 Ä Å ( } 9 nilHandleErr . ° d ONLN d { t Ä fi )ë–109 . ° d ONLN d Ä t Ú Ä! )( Handle ar R` ° d ONLN d â t! ÄM )/
gument is R` ° d ONLN d ì tM Ä_ ),nil ° d ONLN d ò 9 ã ü ( à 9siUnknownInfoType . ° d ONLN d ™ ã fi )ë–231 ° d ONLN d Ø Ú ã )(Featur Á@ ° d ONLN d µ 㣠) e not implemented on synthesizer . ° d ONLN d ◊ ã 9 ó Å ( î 9 noSynthFound . ° d ONLN d ‰ ã ó fi )ë–240 ° d ONLN d È ã Ú ó' )( Could not fi ≠¿ ° d ONLN d ı ã' ób )5nd the specifi Ê` ° d ONLN d ãb ó¬ );ed speech synthesizer . ° d ONLN d ñ 9 ¢ ì ( ü 9synthOpenFailed . ° d ONLN d* ñ ¢ fi )ë–241 ° d ONLN d/ ñ Ú ¢÷ )(1Could not open another speech synthesizer channel . ° d ONLN db ¢ 9 Æ á ( ´ 9synthNotReady . ° d ONLN dp ¢ Æ fi )ë–242 ° d ONLN du ¢ Ú Æ§ )()Speech synthesizer is still busy speaking . ° d ONLN d† ≠ 9 π { ( ∂ 9 bufTooSmall . ° d ONLN d¨ ≠ π fi )ë–243 ° d ONLN d± ≠ Ú π# )(
Output buf & ° d ONLN dª ≠$ πç )2fer is too small to hold r 2Ä ° d ONLN d’ ≠ç π¢ )iesult . ° d ONLN d‹ π 9 ≈ á ( ¬ 9voiceNotFound . ° d ONLN dÍ π ≈ fi )ë–244 ° d ONLN dÔ π Ú ≈ ˘ )(V ú` ° d ONLN d π ¯ ≈ )oice r y ° d ONLN dˆ π ≈( )esour ¡` ° d ONLN d˚ π( ≈_ ) ce not found . ° d ONLN d ƒ 9 – ü ( Õ 9incompatibleVoice . ° d ONLN d ƒ – fi )ë–245 ° d ONLN d ƒ Ú – )(Specifi ‡ ° d ONLN d' ƒ –ƒ ) (ed voice cannot be used with synthesizer . ° d ONLN dQ – 9 ‹ á ( Ÿ 9badDictFormat . ° d ONLN d_ – ‹ fi )ë–246 ° d ONLN dd – Ú ‹ )( Format pr ‘¿ ° d ONLN dm – ‹\ ),oblem with pr r ° d ONLN dz –] ‹¡ )?onunciation dictionary . ° d ONLN dí € 9 Á ç ( ‰ 9badPhonemeText . ° d ONLN d° € Á fi )ë–247 ° d ONLN d¶ € Ú ÁΩ )(,Raw phoneme text contains invalid characters . ° d ONLN d‘ Á 9 Û • ( 9invalidComponentID . ° d ONLN dÁ Á ≈ Û fi )å–3000 . ° d ONLN dÌ Á Ú Û )-Invalid ° d ONLN dı Á Ûe )%SpeechChannel ° d ONLN d Áe Ûó )N
